設定 AWS 區域 - AWS SDK for JavaScript

AWS SDK for JavaScript V3 API 參考指南詳細介紹了 AWS SDK for JavaScript 版本 3(V3)的所有 API 操作。

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

設定 AWS 區域

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

的 SDK 預設 JavaScript 不會選取 [地區]。但是,您可以使用環境變數或共用組態config檔案來設定 AWS Region。

在客戶端類構造函數中

當您實例化服務對象時,可以指定該資源的 AWS Region 作為客戶端類構造函數的一部分,如下所示。

const s3Client = new S3.S3Client({region: 'us-west-2'});

使用環境變數

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

使用共用設定檔

就像共享憑據文件允許您存儲憑據以供 SDK 使用,您可以將 AWS 區域和其他配置設置保存在名config為 SDK 的共享文件中以供使用。如果AWS_SDK_LOAD_CONFIG環境變數設定為真值,SDK 會在載入config檔案時 JavaScript 自動搜尋檔案。config 檔案的儲存位置取決於您的作業系統:

  • Linux、macOS 系統或 Unix 用戶-~/.aws/config

  • 視窗使用者-C:\Users\USER_NAME\.aws\config

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

[default] region=us-west-2 output=json

有關使用共享configcredentials文件的更多信息,請參閱 AWS SDK 和工具參考指南中的共享配置和憑據文件

設定區域的優先順序

以下是「區域」設定的優先順序:

  1. 如將某區域傳遞至用戶端類別建構子,則會使用該區域。

  2. 如果在環境變數中設定了「區域」,則會使用該「區域」。

  3. 否則,會使用共用設定檔中定義的「區域」。