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-access-permissions"></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 コード例は以下を示しています。**
+ Amazon S3 バケットのアクセスコントロールリストの取得または設定方法。

## シナリオ
<a name="w2aac20c25c27c13b9"></a>

この例では、Node.js モジュールを使用して、選択したバケットのバケットアクセス制御リスト (ACL) を表示し、選択したバケットの ACL に変更を適用します。Node.js モジュールは SDK for JavaScript を使用し、Amazon S3 クライアントクラスのこれらのメソッドを使用して、Amazon S3 バケットのアクセス許可を管理します。
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketAcl-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketAcl-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketAcl-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketAcl-property)

Amazon S3 バケットのアクセスコントロールリストに関する詳細は、*Amazon Simple Storage Service ユーザーガイド*の「[ACL によるアクセス管理](https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3_ACLs_UsingACLs.html)」を参照してください。

## 前提条件タスク
<a name="w2aac20c25c27c13c11"></a>

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

## SDK の設定
<a name="s3-example-access-permissions-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'});
```

## 現在のバケットのアクセスコントロールリストの取得
<a name="s3-example-access-permissions-get-acl"></a>

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

`AWS.S3` サービスオブジェクトを作成します。渡す必要がある唯一のパラメータは、`getBucketAcl` メソッドを呼び出すときに選択したバケットの名前です。現在のアクセスコントロールリストの設定は、コールバック関数に渡された `data` パラメータで Amazon S3 によって返されます。

```
// 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" });

var bucketParams = { Bucket: process.argv[2] };
// call S3 to retrieve policy for selected bucket
s3.getBucketAcl(bucketParams, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else if (data) {
    console.log("Success", data.Grants);
  }
});
```

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

```
node s3_getbucketacl.js BUCKET_NAME
```

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