AWS Cloud9 の Node.js チュートリアル

このサンプルを強化して AWS SDK for JavaScript in Node.js を使用し、Amazon S3 バケットを作成して利用可能なバケットをリストし、その後作成したばかりのバケットを削除します。

このステップでは、AWS SDK for JavaScript in Node.js の Amazon S3 サービスクライアントモジュールをインストールして設定しますが、そうすれば、JavaScript コードから、Amazon S3 AWS サービスを簡単に操作できるようになります。

他のAWS サービスを使いたい場合は、個別にインストールする必要があります。AWS モジュールのインストールの詳細については、AWS デベロッパーガイド (V3)を参照してください。Node.js と AWS SDK for JavaScript (V3) の使用を開始する方法については、「AWS SDK for JavaScript デベロッパーガイド (V3)」の「Node.js での開始方法」を参照してください。

AWS SDK for JavaScript in Node.js をインストールしたあと、環境に認証情報管理を設定する必要があります。AWSSDK for JavaScript in Node.js は、AWS サービスとやりとりをするためにこれらの認証情報を必要とします。

AWS SDK for JavaScript in Node.js をインストールするには

npm を使用して install コマンドを実行します。

npm install @aws-sdk/client-s3
                  

詳細については、AWS SDK for JavaScript デベロッパーガイドの「SDK for JavaScript のインストール」を参照してください。

環境で認証情報管理を設定するには

AWS SDK for JavaScript in Node.js を使用して AWS のサービスを呼び出すたびに、呼び出しに一連の認証情報を指定する必要があります。これらの認証情報は AWS SDK for JavaScript in Node.js にその呼び出しを行う適切な許可があるかどうかを判別します。認証情報に適切なアクセス権限がない場合、呼び出しは失敗します。

このステップでは、環境内に認証情報を保存します。これを行うには、AWS Cloud9 の環境から AWS のサービス の呼び出し の手順を実行してから、このトピックに戻ります。

詳細については、AWS SDK for JavaScript Dデベロッパーガイドの「Setting Credentials in Node.js (Noda.jp に認証情報を設定)」を参照してください。

このサンプルを強化して AWS SDK for JavaScript in Node.js を使用し、Amazon S3 バケットを作成して利用可能なバケットをリストし、その後作成したばかりのバケットを削除します。

このステップでは、AWS SDK for JavaScript in Node.js をインストールして設定します。これを使用すると、Amazon S3 などの AWS サービスを JavaScript コードから簡単に操作できます。AWS SDK for JavaScript in Node.js をインストールしたあと、環境に認証情報管理を設定する必要があります。AWSSDK for JavaScript in Node.js は、AWS サービスとやりとりをするためにこれらの認証情報を必要とします。

AWS SDK for JavaScript in Node.js をインストールするには

npm を使用して install コマンドを実行します。

npm install aws-sdk
                  

詳細については、AWS SDK for JavaScript デベロッパーガイドの「SDK for JavaScript のインストール」を参照してください。

環境で認証情報管理を設定するには

AWS SDK for JavaScript in Node.js を使用して AWS のサービスを呼び出すたびに、呼び出しに一連の認証情報を指定する必要があります。これらの認証情報は AWS SDK for JavaScript in Node.js にその呼び出しを行う適切な許可があるかどうかを判別します。認証情報に適切なアクセス権限がない場合、呼び出しは失敗します。

このステップでは、環境内に認証情報を保存します。これを行うには、AWS Cloud9 の環境から AWS のサービス の呼び出し の手順を実行してから、このトピックに戻ります。

詳細については、AWS SDK for JavaScript デベロッパーガイドの「Setting Credentials in Node.js (Noda.jp に認証情報を設定)」を参照してください。

このステップでは、今度は Amazon S3 を操作してバケットを作成し、利用できるバケットのリストを表示した後、作成したバケットを削除するコードをいくつか追加します。このコードは後で実行します。

AWS Cloud9 IDE で、以下の内容のファイルを作成し、s3.js という名前で保存します。

import {
  CreateBucketCommand,
  DeleteBucketCommand,
  ListBucketsCommand,
  S3Client,
} from "@aws-sdk/client-s3";

const wait = async (milliseconds) => {
  return new Promise((resolve) => setTimeout(resolve, milliseconds));
};

export const main = async () => {
  const client = new S3Client({});
  const now = Date.now();
  const BUCKET_NAME = `easy-bucket-${now.toString()}`;

  const createBucketCommand = new CreateBucketCommand({ Bucket: BUCKET_NAME });
  const listBucketsCommand = new ListBucketsCommand({});
  const deleteBucketCommand = new DeleteBucketCommand({ Bucket: BUCKET_NAME });

  try {
    console.log(`Creating bucket ${BUCKET_NAME}.`);
    await client.send(createBucketCommand);
    console.log(`${BUCKET_NAME} created`);

    await wait(2000);

    console.log(`Here are your buckets:`);
    const { Buckets } = await client.send(listBucketsCommand);
    Buckets.forEach((bucket) => {
      console.log(` • ${bucket.Name}`);
    });

    await wait(2000);

    console.log(`Deleting bucket ${BUCKET_NAME}.`);
    await client.send(deleteBucketCommand);
    console.log(`${BUCKET_NAME} deleted`);
  } catch (err) {
    console.error(err);
  }
};

main();
               

このステップでは、今度は Amazon S3 を操作してバケットを作成し、利用できるバケットのリストを表示した後、作成したバケットを削除するコードをいくつか追加します。このコードは後で実行します。

AWS Cloud9 IDE で、以下の内容のファイルを作成し、s3.js という名前で保存します。

if (process.argv.length < 4) {
  console.log(
    "Usage: node s3.js <the bucket name> <the AWS Region to use>\n" +
      "Example: node s3.js my-test-bucket us-east-2"
  );
  process.exit(1);
}

var AWS = require("aws-sdk"); // To set the AWS credentials and region.
var async = require("async"); // To call AWS operations asynchronously.

AWS.config.update({
  region: region,
});

var s3 = new AWS.S3({ apiVersion: "2006-03-01" });
var bucket_name = process.argv[2];
var region = process.argv[3];

var create_bucket_params = {
  Bucket: bucket_name,
  CreateBucketConfiguration: {
    LocationConstraint: region,
  },
};

var delete_bucket_params = { Bucket: bucket_name };

// List all of your available buckets in this AWS Region.
function listMyBuckets(callback) {
  s3.listBuckets(function (err, data) {
    if (err) {
    } else {
      console.log("My buckets now are:\n");

      for (var i = 0; i < data.Buckets.length; i++) {
        console.log(data.Buckets[i].Name);
      }
    }

    callback(err);
  });
}

// Create a bucket in this AWS Region.
function createMyBucket(callback) {
  console.log("\nCreating a bucket named " + bucket_name + "...\n");

  s3.createBucket(create_bucket_params, function (err, data) {
    if (err) {
      console.log(err.code + ": " + err.message);
    }

    callback(err);
  });
}

// Delete the bucket you just created.
function deleteMyBucket(callback) {
  console.log("\nDeleting the bucket named " + bucket_name + "...\n");

  s3.deleteBucket(delete_bucket_params, function (err, data) {
    if (err) {
      console.log(err.code + ": " + err.message);
    }

    callback(err);
  });
}

// Call the AWS operations in the following order.
async.series([
  listMyBuckets,
  createMyBucket,
  listMyBuckets,
  deleteMyBucket,
  listMyBuckets,
]);