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

帮助我们改进Amazon SDK for JavaScript版本 3 (V3) 文档,方法是使用反馈链接,或者在上创建议题或拉取请求GitHub.

这些区域有:Amazon SDK for JavaScriptV3 API 参考指南详细描述了Amazon SDK for JavaScript版本 3 (V3)。

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

设置Amazon区域

网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的Amazon地区是一组命名的Amazon同一地理地区中的资源。区域的一个示例是us-east-1,这是美国东部(弗吉尼亚北部)区域。在适用于 JavaScript 的开发工具包中创建服务客户端时,您可以指定区域,以便开发工具包访问该区域中的服务。有些服务仅在特定区域中提供。

默认情况下,适用于 JavaScript 的开发工具包不选择区域。但是,您可以将Amazon使用环境变量或共享配置的区域config文件。

在客户端类构造函数中

在实例化服务对象时,可以指定Amazon作为客户端类构造函数的一部分,该资源的区域,如此处所示。

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

使用环境变量

您可以使用 AWS_REGION 环境变量设置区域。如果您定义此变量,JavaScript 开发工具包会读取并使用它。

使用共享的配置文件

您可以存储共享凭证文件供开发工具包使用的凭证,您可以保存您的凭证文件。Amazon名为的共享文件中的区域和其他配置设置config供 SDK 使用。如果AWS_SDK_LOAD_CONFIG环境变量设置为真值,JavaScript 开发工具包会自动搜索config文件加载时。保存 config 文件的位置取决于您的操作系统:

  • Linux、macOS 或 Unix 用户-~/.aws/config

  • Windows 用户-C:\Users\USER_NAME\.aws\config

如果您还没有共享 config 文件,您可以在指定的目录中创建一个。在以下示例中,config 文件设置区域和输出格式。

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

有关如何使用共享的更多信息config和凭证文件,请参阅从共享凭证文件加载 Node.js 中的凭证要么配置和凭证文件中的Amazon Command Line Interface用户指南.

设置区域的优先顺序

以下是区域设置的优先顺序:

  1. 如果将某个区域传递给客户端类构造函数,则使用该区域。

  2. 如果环境变量中设置了区域,则使用该区域。

  3. 否则,如果AMAZON_REGION环境变量是真值,使用该区域。

  4. 否则,将使用在共享配置文件中定义的区域。