设置AWS区域 - AWS SDK for JavaScript

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

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

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

设置AWS区域

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

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

在客户端类构造函数中

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

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

使用环境变量

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

使用共享的配置文件

您可以存储共享凭证文件供开发工具包使用的凭证,共享凭证与之非常相似,您可以保存AWS名为的共享文件中的区域和其他配置设置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 中的凭证要么配置和凭证文件中的AWS Command Line Interface用户指南.

设置区域的优先顺序

区域设置的优先顺序如下:

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

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

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