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
有關使用共享config
和credentials
文件的更多信息,請參閱 AWS SDK 和工具參考指南中的共享配置和憑據文件。
設定區域的優先順序
以下是「區域」設定的優先順序:
-
如將某區域傳遞至用戶端類別建構子,則會使用該區域。
-
如果在環境變數中設定了「區域」,則會使用該「區域」。
-
否則,會使用共用設定檔中定義的「區域」。