AWS リージョンの設定 - AWS SDK for JavaScript

AWS SDK for JavaScript v2 の近日発表 end-of-support しました。AWS SDK for JavaScript v3 に移行することをお勧めします。日付、その他の詳細、移行方法については、リンク先の発表内容を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS リージョンの設定

リージョンは、同じ地理的領域にある AWS リソースの名前付きセットです。リージョンの例は us-east-1 です。これは、米国東部 (バージニア北部) リージョンです。リージョンは、SDK がそのリージョンのリソースにアクセスできる JavaScript ように の SDK を設定するときに指定します。 の一部のサービスは、特定のリージョンでのみ利用可能です。

SDK for JavaScript は、デフォルトではリージョンを選択しません。ただし、環境変数、共有 config ファイル、またはグローバル設定オブジェクトを使用してリージョンを設定できます。

クライアントクラスコンストラクタ内

サービスオブジェクトをインスタンス化する場合、次に示すように、クライアントクラスコンストラクタの一部としてリソースの地域を指定することができます。

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

グローバル設定オブジェクトの使用

JavaScript コードでリージョンを設定するには、次に示すようにAWS.Configグローバル設定オブジェクトを更新します。

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

現在のリージョンと、各リージョンで利用可能なサービスの詳細については、「AWS 全般のリファレンス」の「AWS のリージョンとエンドポイント」を参照してください。

環境変数を使用する

AWS_REGION 環境変数を設定して、リージョンを設定できます。この変数を定義すると、 の SDK によってその変数が JavaScript 読み取られ、使用されます。

共有 Config ファイルの使用

共有認証情報ファイルで SDK で使用する認証情報を保存できるのと同じように、リージョンやその他の設定を SDK で使用される config という名前の共有ファイルに保存できます。AWS_SDK_LOAD_CONFIG 環境変数が真の値に設定されている場合、SDK for はロード時にconfigファイル JavaScript を自動的に検索します。 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 に認証情報をロードする設定ファイルと認証情報ファイルを参照してください。

リージョン設定の優先順位

リージョン設定の優先順位は以下のとおりです。

  • リージョンがクライアントクラスコンストラクタに渡された場合、そのリージョンが使用されます。そうでない場合は、次に、

  • グローバル設定オブジェクトにリージョンが設定されている場合は、そのリージョンが使用されます。そうでない場合は、次に、

  • AWS_REGION 環境変数がの値である場合は、そのリージョンが使用されます。そうでない場合は、次に、

  • AMAZON_REGION 環境変数が真の値である場合は、そのリージョンが使用されます。そうでない場合は、次に、

  • AWS_SDK_LOAD_CONFIG 環境変数が真の値に設定されていて、共有認証情報ファイル (~/.aws/credentials または AWS_SHARED_CREDENTIALS_FILE で示されるパス) に設定済みプロファイルのリージョンが含まれている場合は、そのリージョンが使用されます。そうでない場合は、次に、

  • AWS_SDK_LOAD_CONFIG 環境変数が真の値に設定されていて、config ファイル (~/.aws/config または AWS_CONFIG_FILE で示されるパス) に設定済みプロファイルのリージョンが含まれている場合は、そのリージョンが使用されます。