適用於 JavaScript 的 AWS SDK V3 API 參考指南詳細說明 第 3 版 適用於 JavaScript 的 AWS SDK (V3) 的所有 API 操作。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
每個服務的組態
您可以透過將組態資訊傳遞至服務物件來設定 SDK。
服務層級組態可大幅控制個別服務,讓您在需求與預設組態不同時更新個別服務物件的組態。
注意
在 2.x 版 適用於 JavaScript 的 AWS SDK 的服務組態中,可以傳遞給個別用戶端建構函式。不過,這些組態會先自動合併到全域 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});