适用于 JavaScript 的 AWS SDKV3 API 参考指南详细描述了 适用于 JavaScript 的 AWS SDK 版本 3 (V3) 的所有 API 操作。

设置 AWS 区域

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

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

在客户端类构造函数中

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

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

使用环境变量

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

使用共享配置文件

您可以存储共享凭证文件供 SDK 使用的凭证，共享配置文件与之非常相似，您可以将 AWS 区域和其他配置设置保存在供 SDK 使用的名为 config 的共享文件中。如果 AWS_SDK_LOAD_CONFIG 环境变量已设置为真值，则在加载时 SDK for JavaScript 会自动搜索 config 文件。保存 config 文件的位置取决于您的操作系统：

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

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

有关使用共享 config 和 credentials 文件的更多信息，请参阅 AWS SDK 和工具参考指南 中的共享配置和凭证文件。

设置区域的优先顺序

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