Help us improve the AWS SDK for JavaScript version 3 (V3) documentation by providing feedback using the Feedback link, or create an issue or pull request on GitHub.

The AWS SDK for JavaScript V3 API Reference Guide describes in detail all the API operations for the AWS SDK for JavaScript version 3 (V3).

Getting started in Node.js

This Node.js code example shows:

The scenario

The example shows how to set up and run a simple Node.js module that creates an Amazon S3 bucket, then adds a text object to it.

Prerequisite tasks

To set up and run this example, you must first complete these tasks:

Step 1: Install the Amazon S3 package and dependencies

To install the client package and dependencies:

Step 2: Write the Node.js code

Create a file named sampleClient.js to contain the client for creating the Amazon S3 service client object. Copy and paste the code below into it. Replace REGION with your AWS Region.

import { S3Client } from "@aws-sdk/client-s3";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create an Amazon S3 service client object.
const s3Client = new S3Client({ region: REGION });
export { s3Client };

The example code can be found here on GitHub.

First, define the parameters by replacing BUCKET_NAME with the name of the bucket, KEY with the name of the new object, BODY with some content for the new object.

Next, create an Amazon S3 client object. Then create an async wrapper function that runs two try/catch statements in sequence. The first try/catch statement creates the bucket, and the second creates and uploads the new object.

To create the bucket, you create a constant that runs the CreateBucketCommand using the .send method using the async/await pattern, passing in the name of the new bucket. The await keyword blocks execution of all the code that follows until the bucket is created. If an error occurs, the first catch statement returns an error.

To create and upload an object to the new bucket after it is created, you create a constant that runs the PutObjectCommand, also using the .send method using the async/await pattern, and passing in the bucket, key, and body parameters. If an error occurs, the second catch statement returns an error.

// Import required AWS SDK clients and commands for Node.js.
import { PutObjectCommand, CreateBucketCommand } from "@aws-sdk/client-s3";
import { s3Client } from "./libs/s3Client.js";

// Set the parameters
const params = {
  Bucket: "BUCKET_NAME", // The name of the bucket. For example, 'sample_bucket_101'.
  Key: "KEY", // The name of the object. For example, 'sample_upload.txt'.
  Body: "BODY", // The content of the object. For example, 'Hello world!".
};

const run = async () => {
  // Create an Amazon S3 bucket.
  try {
    const data = await s3Client.send(
        new CreateBucketCommand({ Bucket: params.Bucket })
    );
    console.log(data);
    console.log("Successfully created a bucket called ", data.Location);
    return data; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
  // Create an object and upload it to the Amazon S3 bucket.
  try {
    const results = await s3Client.send(new PutObjectCommand(params));
    console.log(
        "Successfully created " +
        params.Key +
        " and uploaded it to " +
        params.Bucket +
        "/" +
        params.Key
    );
    return results; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

The example code can be found here on GitHub.

Step 3: Run the example

Enter the following command to run the example.

node sample.js

If the upload is successful, you'll see a confirmation message at the command prompt. You can also find the bucket and the uploaded text object in the Amazon S3 console.