管理 Amazon S3 儲存貯體存取許可 - AWS SDK for JavaScript
使用案例先決條件任務設定軟體開發套件擷取現有儲存貯體存取控制清單

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

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

管理 Amazon S3 儲存貯體存取許可

JavaScript code example that applies to Node.js execution

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

  • 如何擷取或設定 Amazon S3 儲存貯體的存取控制清單。

使用案例

在此範例中，Node.js 模組用於顯示所選儲存貯體的儲存貯體存取控制清單 (ACL)，並套用變更至所選儲存貯體的 ACL。Node.js 模組使用開發套件，使用 Amazon S3 用戶端類別的下列方法 JavaScript 來管理 Amazon S3 儲存貯體存取許可：

如需 Amazon S3 儲存貯體存取控制清單的詳細資訊，請參閱 Amazon 簡單儲存服務使用者指南中的使用 ACL 管理存取。

先決條件任務

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

設定軟體開發套件

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_getbucketacl.js 建立一個 Node.js 模組。該模組將採用單一命令行引數來指定您需要的 ACL 組態之儲存貯體。請務必依前述的內容來設定軟體開發套件。

建立一個 AWS.S3 服務物件。您唯一需要傳遞的參數，就是在呼叫 getBucketAcl 方法時所選取儲存貯體的名稱。Amazon S3 會在傳遞至回呼函數的data參數中傳回目前的存取控制清單組態。

// 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。