[适用于 JavaScript 的 AWS SDK V3 API 参考指南](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)详细描述了 适用于 JavaScript 的 AWS SDK 版本 3 (V3) 的所有 API 操作。

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

# 设置 AWS 区域
<a name="setting-region"></a>

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

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

## 在客户端类构造函数中
<a name="setting-region-constructor"></a>

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

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

## 使用环境变量
<a name="setting-region-environment-variable"></a>

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

## 使用共享配置文件
<a name="setting-region-config-file"></a>

就像共享凭据文件允许您存储证书以供 SDK 使用一样，您可以将 AWS 区域和其他配置设置保存在名为 `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
```

有关使用共享`config`和`credentials`文件的更多信息，请参阅《工具参考指南》[和《*工具参考指南》中的共享配置AWS SDKs 和*凭据文件](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。

## 设置区域的优先顺序
<a name="setting-region-order-of-precedence"></a>

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

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

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

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