[適用於 JavaScript 的 AWS SDK V3 API 參考指南](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)詳細說明 第 3 版 適用於 JavaScript 的 AWS SDK (V3) 的所有 API 操作。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 AWS 區域
<a name="setting-region"></a>

 AWS 區域是相同地理區域中的一組具名 AWS 資源。區域的範例為 `us-east-1`，即美國東部 （維吉尼亞北部） 區域。您可以在適用於 JavaScript 的 SDK 中建立服務用戶端時指定區域，以便 SDK 存取該區域中的服務。某些 服務僅在特定區域提供。

適用於 JavaScript 的 SDK 預設不會選取區域。不過，您可以使用環境變數或共用組態`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` 環境變數來設定區域。如果您定義此變數，適用於 JavaScript 的 SDK 會讀取並使用它。

## 使用共用組態檔案
<a name="setting-region-config-file"></a>

就像共用登入資料檔案可讓您存放登入資料以供軟體開發套件使用一樣，您可以將 AWS 區域和其他組態設定保留在名為 `config` 的共用檔案中，供軟體開發套件使用。如果`AWS_SDK_LOAD_CONFIG`環境變數設定為真實值，適用於 JavaScript 的 SDK 會在載入時自動搜尋`config`檔案。`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. 否則，會使用共用組態檔案中定義的區域。