我們宣布即將推出 end-of-support AWS SDK for JavaScript v2。建議您遷移至 AWS SDK for JavaScript v3。如需日期、其他詳細資訊和如何遷移的資訊，請參閱連結公告。

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

設定 Amazon S3 儲存貯體

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

使用案例

在此範例中使用了一系列的 Node.js 模組以列出您的 Amazon S3 儲存貯體，以及設定 CORS 和儲存貯體記錄。Node.js 模組使用開發套件，使用 Amazon S3 用戶端類別的下列方法 JavaScript 來設定選取的 Amazon S3 儲存貯體：

如需將 CORS 組態與 Amazon S3 儲存貯體搭配使用的詳細資訊，請參閱 Amazon 簡單儲存服務使用者指南中的跨來源資源共用 (CORS)。

先決條件任務

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

設定軟體開發套件

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'});

擷取儲存貯體 CORS 組態

以檔名 s3_getcors.js 建立一個 Node.js 模組。該模組將採用單一命令行引數來指定您需要的 CORS 組態之儲存貯體。請務必依前述的內容來設定軟體開發套件。建立一個 AWS.S3 服務物件。

您唯一需要傳遞的參數，就是在呼叫 getBucketCors 方法時所選取儲存貯體的名稱。如果儲存貯體目前具有 CORS 組態，Amazon S3 會傳回該組態，做為傳遞至回呼函數的data參數CORSRules屬性。

如果所選的儲存貯體沒有 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。

設定儲存貯體 CORS 組態

以檔名 s3_setcors.js 建立一個 Node.js 模組。該模組採用多個命令行引數，第一個指定您想設定的 CORS 組態之儲存貯體。其他引數列舉您要為儲存貯體允許的 HTTP 方法 (POST, GET, PUT, PATCH, DELETE, POST)。依前述內容設定軟體開發套件。

建立一個 AWS.S3 服務物件。接下來，視 AWS.S3 服務物件的 putBucketCors 方法需要，建立一個 JSON 物件以保存 CORS 組態的值。為 AllowedHeaders 值指定 "Authorization"，並為 AllowedOrigins 值指定 "*"。在初始時設 AllowedMethods 值為空陣列。

指定允許的方法為命令列參數至 Node.js 模組，新增符合其中一個參數的各種方法。新增產生的 CORS 組態至包含在 CORSRules 參數中的組態陣列。在 Bucket 參數中指定您要為 CORS 設定的儲存貯體。

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

若要執行範例，請在命令列中輸入以下內容 (包含所示的一個或更多 HTTP 方法)。

node s3_setcors.js BUCKET_NAME get put

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