

AWS SDK for JavaScript v2 はサポート終了となりました。[AWS SDK for JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) に移行することをお勧めします。その他の詳細、移行方法については、こちらの[発表内容](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)を参照してください。

# Amazon S3 バケットの設定
<a name="s3-example-configuring-buckets"></a>

![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/ja_jp/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)

**この Node.js コード例は以下を示しています。**
+ バケットにクロスオリジンリソース共有 (CORS) アクセス許可を設定する方法。

## シナリオ
<a name="s3-example-configuring-buckets-scenario"></a>

この例では、一連の Node.js モジュールを使用して Amazon S3 バケットを一覧表示し、CORS とバケットのログ記録を設定します。Node.js モジュールは SDK for JavaScript を使用し、Amazon S3 クライアントクラスのこれらのメソッドを使用して、選択した Amazon S3 バケットを設定します。
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketCors-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketCors-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketCors-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketCors-property)

Amazon S3 バケットで CORS 設定を使用する方法の詳細については、*Amazon Simple Storage Service ユーザーガイド*の「[Cross-Origin Resource Sharing (CORS)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html)」を参照してください。

## 前提条件タスク
<a name="s3-example-configuring-buckets-prerequisites"></a>

この例をセットアップして実行するには、まず次のタスクを完了する必要があります。
+ Node.js をインストールします。Node.js をインストールする方法の詳細については、[Node.js ウェブサイト](https://nodejs.org)を参照してください。
+ ユーザーの認証情報を使用して、共有設定ファイルを作成します。共有認証情報ファイルの提供の詳細については、[共有認証情報ファイルから Node.js に認証情報をロードする](loading-node-credentials-shared.md) を参照してください。

## SDK の設定
<a name="s3-example-configuring-buckets-configure-sdk"></a>

グローバル設定オブジェクトを作成してからコードのリージョンを設定することで、SDK for JavaScript を設定します。この例では、リージョンは `us-west-2` に設定されています。

```
// Load the SDK for JavaScript
var AWS = require('aws-sdk');
// Set the Region 
AWS.config.update({region: 'us-west-2'});
```

## バケットの CORS 設定を取得する
<a name="s3-example-configuring-buckets-get-cors"></a>

`s3_getcors.js` というファイル名で Node.js モジュールを作成します。モジュールは単一のコマンドライン引数を取り、必要な CORS 設定があるバケットを指定します。前に示したように、SDK が設定されていることを確認します。`AWS.S3` サービスオブジェクトを作成します。

渡す必要がある唯一のパラメータは、`getBucketCors` メソッドを呼び出すときに選択したバケットの名前です。バケットに現在 CORS 設定がある場合、その設定はコールバック関数に渡された `data` パラメータの `CORSRules` プロパティとして Amazon S3 によって返されます。

選択したバケットに CORS 設定がない場合、その情報は `error` パラメータでコールバック関数に返されます。

```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create S3 service object
s3 = new AWS.S3({ apiVersion: "2006-03-01" });

// Set the parameters for S3.getBucketCors
var bucketParams = { Bucket: process.argv[2] };

// call S3 to retrieve CORS configuration for selected bucket
s3.getBucketCors(bucketParams, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else if (data) {
    console.log("Success", JSON.stringify(data.CORSRules));
  }
});
```

この例を実行するには、コマンドラインに次のように入力します。

```
node s3_getcors.js BUCKET_NAME
```

 このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_getcors.js)にあります。

## バケットの CORS 設定をセットする
<a name="s3-example-configuring-buckets-put-cors"></a>

`s3_setcors.js` というファイル名で Node.js モジュールを作成します。このモジュールは複数のコマンドライン引数を取ります。最初の引数は、CORS 設定をセットするバケットを指定します。追加の引数は、バケットに許可する HTTP メソッド (POST、GET、PUT、PATCH、DELETE、POST) を列挙します。前に示したように SDK を設定します。

 `AWS.S3` サービスオブジェクトを作成します。次に、`putBucketCors` サービスオブジェクトの `AWS.S3` メソッドで必要とされる CORS 設定の値を保持する JSON オブジェクトを作成します。`"Authorization"` 値の `AllowedHeaders`、および `"*"` 値の `AllowedOrigins` を指定します。最初は `AllowedMethods` の値を空の配列に設定してください。

許可されるメソッドを Node.js モジュールへのコマンドラインパラメータとして指定し、いずれかのパラメータに一致する各メソッドを追加します。結果の CORS 設定を `CORSRules` パラメータに含まれる設定の配列に追加します。CORS 用に設定するバケットを `Bucket` パラメータで指定します。

```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create S3 service object
s3 = new AWS.S3({ apiVersion: "2006-03-01" });

// Create initial parameters JSON for putBucketCors
var thisConfig = {
  AllowedHeaders: ["Authorization"],
  AllowedMethods: [],
  AllowedOrigins: ["*"],
  ExposeHeaders: [],
  MaxAgeSeconds: 3000,
};

// Assemble the list of allowed methods based on command line parameters
var allowedMethods = [];
process.argv.forEach(function (val, index, array) {
  if (val.toUpperCase() === "POST") {
    allowedMethods.push("POST");
  }
  if (val.toUpperCase() === "GET") {
    allowedMethods.push("GET");
  }
  if (val.toUpperCase() === "PUT") {
    allowedMethods.push("PUT");
  }
  if (val.toUpperCase() === "PATCH") {
    allowedMethods.push("PATCH");
  }
  if (val.toUpperCase() === "DELETE") {
    allowedMethods.push("DELETE");
  }
  if (val.toUpperCase() === "HEAD") {
    allowedMethods.push("HEAD");
  }
});

// Copy the array of allowed methods into the config object
thisConfig.AllowedMethods = allowedMethods;
// Create array of configs then add the config object to it
var corsRules = new Array(thisConfig);

// Create CORS params
var corsParams = {
  Bucket: process.argv[2],
  CORSConfiguration: { CORSRules: corsRules },
};

// set the new CORS configuration on the selected bucket
s3.putBucketCors(corsParams, function (err, data) {
  if (err) {
    // display error message
    console.log("Error", err);
  } else {
    // update the displayed CORS config for the selected bucket
    console.log("Success", data);
  }
});
```

例を実行するには、コマンドラインに次に示すように 1 つ以上の HTTP メソッドを含めて次を入力します。

```
node s3_setcors.js BUCKET_NAME get put
```

 このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_setcors.js)にあります。