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

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

設定 AWS 區域

「地區」是同一地理區域中的一組具名 AWS 資源。區域的範例為us-east-1美國東部 (維吉尼亞北部) 區域。您可以在為其配置 SDK 時指定「區域」， JavaScript 以便 SDK 存取該區域中的資源。某些 服務僅在特定區域提供。

的 SDK 預設 JavaScript 不會選取 [地區]。然而，您可以使用環境變數 (一個共用的 config 檔案) 或是全域組態物件來設定區域。

在用戶端類別建構子

當您初始化服務物件時，您可以將該資源的區域指定為用戶端類別建構子中的一部分，如此處所示。

var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-east-1'});

使用全域組態物件

若要在 JavaScript 程式碼中設定 Region，請更新AWS.Config全域設定物件，如下所示。

AWS.config.update({region: 'us-east-1'});

如需有關目前區域和每個區域中可用服務的詳細資訊，請參閱AWSAWS 一般參考.

使用環境變數

您可以使用 AWS_REGION 環境變數來設定區域。如果您定義此變數，用於 JavaScript 讀取並使用它的 SDK。

使用共用組態檔

與共用組態檔讓您存放軟體開發套件所用的登入資料的方式類似，您可以在軟體開發套件所用、名為 config 的共用檔中保留區域和其他組態設定。如果AWS_SDK_LOAD_CONFIG環境變數已設定為任何值，SDK 會在載入config檔案時 JavaScript 自動搜尋檔案。 config 檔案的儲存位置取決於您的作業系統：

如果您還沒有共用 config 檔案，您可以在指定的目錄中建立一個。在下列範例中，config 檔案會同時設定區域和輸出格式。

[default]
   region=us-east-1
   output=json

如需有關使用共用設定和認證檔案的詳細資訊，請參閱使AWS Command Line Interface 用指南中的從共用登入資料檔案中在 Node.js 中載入登入資料或「組態與認證檔案」。

設定區域的優先順序

區域設定的優先順序如下：