我們宣布了即將推 end-of-support 出的 AWS SDK for JavaScript v2。我們建議您移轉至 AWS SDK for JavaScript v3。有關日期，其他詳細信息以及如何遷移的信息，請參閱鏈接的公告。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

處理 Amazon S3 儲存貯體政策

這個 Node.js 程式碼範例會說明：

使用案例

在此範例中，使用一系列 Node.js 模組來擷取、設定或刪除 Amazon S3 儲存貯體上的儲存貯體政策。Node.js 模組使用的開發套件，使用 JavaScript Amazon S3 用戶端類別的下列方法，為選定的 Amazon S3 儲存貯體設定政策：

如需 Amazon S3 儲存貯體政策的詳細資訊，請參閱 Amazon 簡單儲存貯體服務使用者指南中的使用儲存貯體政策和使用者政策。

先決條件任務

若要設定和執行此範例，您必須先完成這些任務：

設定軟體開發套件

JavaScript 通過創建全局配置對象，然後為代碼設置區域來配置 SDK。在此範例中，區域會設為 us-west-2。

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

擷取目前儲存貯體政策

以檔名 s3_getbucketpolicy.js 建立一個 Node.js 模組。該模組採用指定您想要政策的儲存貯體之單一命令行引數。請務必依前述的內容來設定軟體開發套件。

建立一個 AWS.S3 服務物件。您唯一需要傳遞的參數，就是在呼叫 getBucketPolicy 方法時所選取儲存貯體的名稱。如果儲存貯體目前有政策，Amazon S3 會在傳遞至回呼函data數的參數中傳回該政策。

如果所選的儲存貯體沒有政策，則該資訊會在 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" });

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

若要執行範例，請在命令列中輸入以下內容。

node s3_getbucketpolicy.js BUCKET_NAME

您可以在這裡找到此範例程式碼 GitHub。

設定簡易儲存貯體政策

以檔名 s3_setbucketpolicy.js 建立一個 Node.js 模組。該模組採用的單一命令行引數，指定了您想套用政策的儲存貯體。依前述內容設定軟體開發套件。

建立一個 AWS.S3 服務物件。儲存貯體政策是在 JSON 中指定。首先，建立包含所有值 (識別儲存貯體的 Resource 值除外) 的 JSON 物件，以指定政策。

格式化政策所需的 Resource 字串，整合該所選的儲存貯體名稱。將字串插入至 JSON 物件。準備該參數以供 putBucketPolicy 方法使用，包括儲存貯體名稱和轉換為字串值的 JSON 政策。

// 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 readOnlyAnonUserPolicy = {
  Version: "2012-10-17",
  Statement: [
    {
      Sid: "AddPerm",
      Effect: "Allow",
      Principal: "*",
      Action: ["s3:GetObject"],
      Resource: [""],
    },
  ],
};

// create selected bucket resource string for bucket policy
var bucketResource = "arn:aws:s3:::" + process.argv[2] + "/*";
readOnlyAnonUserPolicy.Statement[0].Resource[0] = bucketResource;

// convert policy JSON into string and assign into params
var bucketPolicyParams = {
  Bucket: process.argv[2],
  Policy: JSON.stringify(readOnlyAnonUserPolicy),
};

// set the new policy on the selected bucket
s3.putBucketPolicy(bucketPolicyParams, function (err, data) {
  if (err) {
    // display error message
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

若要執行範例，請在命令列中輸入以下內容。

node s3_setbucketpolicy.js BUCKET_NAME

您可以在這裡找到此範例程式碼 GitHub。

刪除儲存貯體政策

以檔名 s3_deletebucketpolicy.js 建立一個 Node.js 模組。該模組採用的單一命令行引數，指定了您想刪除的政策之儲存貯體。依前述內容設定軟體開發套件。

建立一個 AWS.S3 服務物件。您在呼叫 deleteBucketPolicy 方法時唯一需要傳遞的參數，就是所選取儲存貯體的名稱。

// 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 delete policy for selected bucket
s3.deleteBucketPolicy(bucketParams, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else if (data) {
    console.log("Success", data);
  }
});

若要執行範例，請在命令列中輸入以下內容。

node s3_deletebucketpolicy.js BUCKET_NAME

您可以在這裡找到此範例程式碼 GitHub。