设置 Amazon 区域 - 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 操作。

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

设置 Amazon 区域

Amazon 区域是同一地理区域内的一组命名 Amazon 资源。区域的一个例子是 us-east-1,即美国东部(弗吉尼亚州北部)区域。在为的 SDK 中创建服务客户端时,您需要指定一个区域, JavaScript 这样 SDK 就可以访问该区域中的服务。有些服务仅在特定区域中提供。

默认情况下,的 SDK JavaScript 不选择区域。但是,您可以使用环境变量或共享配置config文件来设置 Amazon 区域。

在客户端类构造函数中

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

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

使用环境变量

您可以使用 AWS_REGION 环境变量设置区域。如果您定义了此变量,则的 SDK 会 JavaScript 读取并使用它。

使用共享配置文件

就像共享凭据文件允许您存储证书以供 SDK 使用一样,您可以将 Amazon 区域和其他配置设置保存在名为 config SDK 使用的共享文件中。如果将AWS_SDK_LOAD_CONFIG环境变量设置为真实值,则 SDK 会在加载config文件时 JavaScript 自动搜索文件。保存 config 文件的位置取决于您的操作系统:

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

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

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

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

有关使用共享 configcredentials 文件的更多信息,请参阅 Amazon SDK 和工具参考指南 中的共享配置和凭证文件

设置区域的优先顺序

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

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

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

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

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