AWS SDK for JavaScript V3 API リファレンスガイドでは、AWS SDK for JavaScript バージョン3 (V3) のすべての API オペレーションについて詳しく説明します。

AWS リージョンの設定

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

SDK for JavaScript は、デフォルトではリージョンを選択しません。ただし、環境変数、または共有の設定configファイルを使用してAWS 地域を設定できます。

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

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

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

環境変数の使用

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

共有 Config ファイルの使用

共有認証情報ファイルで SDKで使用する認証情報を保存できるのと同じように、AWS 地域やその他の構成設定をSDKで使用されるconfigという名前の共有ファイルに保存できます。AWS_SDK_LOAD_CONFIG 環境変数が真の値に設定されている場合、SDK for JavaScript はロード時にconfigファイルを自動的に検索します。config ファイルを保存する場所はオペレーティングシステムによって異なります。

共有 config ファイルがまだない場合は、指定されたディレクトリに 1 つ作成することができます。次の例では、config ファイルはリージョンと出力形式の両方を設定します。

[default]
   region=us-west-2
   output=json

共有された config および credentials ファイルの使用についての詳細は、「AWS SDK とツールのリファレンスガイド」の「共有設定ファイルおよび認証情報ファイル」を参照してください。

地域設定の優先順位

地域設定の優先順位は以下の通りです。