AWS SDK for JavaScript v2 はサポート終了となりました。[AWS SDK for JavaScript 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` です。これは、米国東部 (バージニア北部) リージョンです。SDK for JavaScript を設定するときにリージョンを指定して、SDK がそのリージョン内のリソースにアクセスできるようにします。一部のサービスは、特定のリージョンでのみ利用可能です。

SDK for JavaScript は、デフォルトではリージョンを選択しません。ただし、環境変数、共有 `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 全般のリファレンス*」の「[AWS のリージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html)」を参照してください。

## 環境変数を使用する
<a name="setting-region-environment-variable"></a>

`AWS_REGION` 環境変数を設定して、リージョンを設定できます。この変数を定義すると、SDK for JavaScript がそれを読み込み、使用します。

## 共有 Config ファイルの使用
<a name="setting-region-config-file"></a>

共有認証情報ファイルで SDK で使用する認証情報を保存できるのと同じように、リージョンやその他の設定を SDK で使用される `config` という名前の共有ファイルに保存できます。`AWS_SDK_LOAD_CONFIG` 環境変数を任意の値に設定している場合、SDK for JavaScript はロード時に `config` ファイルを自動的に検索します。` config` ファイルを保存する場所はオペレーティングシステムによって異なります。
+ Linux、macOS、Unix ユーザー: `~/.aws/config`
+ Windows ユーザー: `C:\Users\USER_NAME\.aws\config`

共有 `config` ファイルがまだない場合は、指定されたディレクトリに 1 つ作成することができます。次の例では、`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` 環境変数を任意の値に設定していて、config ファイル (`~/.aws/config`、または `AWS_CONFIG_FILE` に示されているパス) に設定済みプロファイルのリージョンが含まれている場合は、そのリージョンが使用されます。