每个服务的配置 - Amazon SDK for JavaScript
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Amazon SDK for JavaScript V3 API 参考指南详细描述了 Amazon SDK for JavaScript 版本 3 (V3) 的所有 API 操作。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

每个服务的配置

您可以通过将配置信息传递给服务对象来配置 SDK。

服务级别配置提供了对各项服务的有效控制,使您能够在需求与默认配置不同时更新各项服务对象的配置。

注意

在 2.x 版本中,可以将 Amazon SDK for JavaScript 服务配置传递给各个客户端构造函数。但是,这些配置将首先自动合并到全局 SDK 配置 AWS.config 的副本中。

此外,调用 AWS.config.update({/* params *}) 仅更新在执行更新调用后实例化的服务客户端的配置,而不是任何现有客户端的配置。

这种行为经常引起混乱,因此很难向仅以向前兼容的方式影响一部分服务客户端的全局对象添加配置。在版本 3 中,不再有由 SDK 管理的全局配置。必须将配置传递至每个实例化的服务客户端。仍然可以在多个客户端之间共享相同的配置,但是该配置不会自动与全局状态合并。

为每项服务设置配置

您在 SDK 中使用的每项服务均通过服务对象进行访问,该服务对象是该服务 API 的一部分。 JavaScript 例如,要访问亚马逊 S3 服务,您需要创建 Amazon S3 服务对象。您可以将特定于某项服务的配置设置指定为该服务对象的构造函数的一部分。

例如,如果您需要访问多个 Amazon 区域中的 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});