每個服務的組態 - AWS SDK for JavaScript

AWS SDK for JavaScript V3 API 參考指南會詳細說明第 3 版 AWS SDK for JavaScript (V3) 的所有 API 操作。

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

每個服務的組態

您可以透過將組態資訊傳遞至服務物件來設定 SDK。

服務層級組態可大幅控制個別服務,讓您在需求與預設組態不同時更新個別服務物件的組態。

注意

在 2.x 版 AWS SDK for JavaScript 的服務組態中,可以傳遞給個別用戶端建構器。不過,這些組態會先自動合併到全域 SDK 組態 的副本AWS.config

此外,AWS.config.update({/* params *})僅針對在進行更新呼叫後所執行個體化的服務用戶端呼叫更新組態,而不是任何現有的用戶端。

此行為經常造成混淆,並使得將組態新增至全域物件變得很難,而這些組態只會以向前相容的方式影響服務用戶端的子集。在版本 3 中,不再有由 SDK 管理的全域組態。組態必須傳遞給每個執行個體化的服務用戶端。仍然可以在多個用戶端之間共用相同的組態,但該組態不會自動與全域狀態合併。

設定每個服務的組態

您在適用於 JavaScript 的 SDK 中使用的每個服務,都是透過該服務 API 的服務物件來存取。例如,若要存取 Amazon S3 服務,您可以建立 Amazon S3 服務物件。您可以指定組態設定,該設定是專屬於該服務物件之建構子的服務。

例如,如果您需要存取多個 AWS 區域中的 Amazon EC2 物件,請為每個區域建立 Amazon EC2 服務物件,然後相應地設定每個服務物件的區域組態。

var ec2_regionA = new EC2({region: 'ap-southeast-2', maxAttempts: 15}); var ec2_regionB = new EC2({region: 'us-west-2', maxAttempts: 15});