適用於 JavaScript 的 AWS SDK v2 已end-of-support。我們建議您遷移至 [適用於 JavaScript 的 AWS SDK v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/)。如需如何遷移的其他詳細資訊和資訊，請參閱此[公告](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)。

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

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

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

適用於 JavaScript 的 SDK 預設不會選取區域。然而，您可以使用環境變數 (一個共用的 `config` 檔案) 或是全域組態物件來設定區域。

## 在用戶端類別建構子
<a name="setting-region-constructor"></a>

當您初始化服務物件時，您可以將該資源的區域指定為用戶端類別建構子中的一部分，如此處所示。

```
var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-east-1'});
```

## 使用全域組態物件
<a name="setting-region-config-object"></a>

若要在 JavaScript 程式碼中設定區域，請如此處所示，更新 `AWS.Config` 全域組態物件。

```
AWS.config.update({region: 'us-east-1'});
```

如需每個區域中目前區域和可用服務的詳細資訊，請參閱《》中的[AWS 區域和端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)*AWS 一般參考*。

## 使用環境變數
<a name="setting-region-environment-variable"></a>

您可以使用 `AWS_REGION` 環境變數來設定區域。如果您定義此變數，適用於 JavaScript 的 SDK 會讀取並使用它。

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

與共用組態檔讓您存放軟體開發套件所用的登入資料的方式類似，您可以在軟體開發套件所用、名為 `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-east-1
   output=json
```

如需使用共用組態和登入資料檔案的詳細資訊，請參閱*AWS Command Line Interface 《 使用者指南*》中的 [從共用登入資料檔案中在 Node.js 中載入登入資料](loading-node-credentials-shared.md)或[組態和登入資料檔案](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html)。

## 設定區域的優先順序
<a name="setting-region-order-of-precedence"></a>

區域設定的優先順序如下：
+ 如將某區域傳遞至用戶端類別建構子，則會使用該區域。如果沒有，則…
+ 如在全域建構子物件上設定某區域，則會使用該區域。如果沒有，則…
+ 如果 `AWS_REGION` 環境變數是[真值](https://developer.mozilla.org/en-US/docs/Glossary/Truthy)，則會使用該區域。如果沒有，則…
+ 如果 `AMAZON_REGION` 環境變數是真值，則會使用該區域。如果沒有，則…
+ 如果`AWS_SDK_LOAD_CONFIG`環境變數設定為任何值，且共用的登入資料檔案 (`~/.aws/credentials` 或 指示的路徑`AWS_SHARED_CREDENTIALS_FILE`) 包含已設定設定檔的區域，則會使用該區域。如果沒有，則…
+ 如果`AWS_SDK_LOAD_CONFIG`環境變數設定為任何值，且組態檔案 (`~/.aws/config` 或 指示的路徑`AWS_CONFIG_FILE`) 包含已設定設定檔的區域，則會使用該區域。