AWS リージョンを設定する - AWS SDK for .NET

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

AWS リージョンを設定する

AWS リージョンにより、特定の地理的リージョンに物理的に存在する AWS サービスにアクセスすることができます。これは、冗長性と、ユーザーがアクセスする場所の近くでのデータとアプリケーションの実行を維持するために有効です。

各 AWS サービスでサポートされているすべてのリージョンとエンドポイントの現在のリストを表示するには、AWS 全般のリファレンスの「DD のサービス エンドポイントとクォータ」を参照してください。既存のリージョンエンドポイントのリストを表示するには、AWSサービスエンドポイントを参照してください。リージョンの詳細については、「アカウントで使用できる AWS リージョンを指定する」を参照してください。

特定のリージョンにアクセスする AWS サービスクライアントを作成できます。また、すべての AWS サービスクライアントに使用されるリージョンを使用してアプリケーションを設定することもできます。次に、この 2 つのケースについて説明します。

特定のリージョンを使用してサービスクライアントを作成する

アプリケーションのいずれかの AWS サービスクライアント用にリージョンを指定できます。この方法でのリージョンの設定は、特定のサービスクライアントのグローバル設定よりも優先されます。

既存のリージョン

この例では、既存のリージョンで Amazon EC2 クライアントをインスタンス化する方法を示します。ここでは、定義済み RegionEndpoint フィールドを使用します。

using (AmazonEC2Client ec2Client = new AmazonEC2Client(RegionEndpoint.USWest2)) { // Make a request to EC2 in the us-west-2 Region using ec2Client }

RegionEndpoint クラスを使用した新しいリージョン

この例では、RegionEndpoint.GetBySystemName を使用して新しいリージョンエンドポイントを作成する方法を示しています。

var newRegion = RegionEndpoint.GetBySystemName("us-west-new"); using (var ec2Client = new AmazonEC2Client(newRegion)) { // Make a request to EC2 in the new Region using ec2Client }

サービスクライアント設定クラスを使用した新しいリージョン

この例では、サービスクライアント設定クラスの ServiceURL プロパティを使用してリージョンを指定する方法を示しています (この例では、Amazonec2Config クラスを使用)。

この手法は、エンドポイントリージョンが通常のエンドポイントパターンに従っていない場合でも有効です。

var ec2ClientConfig = new AmazonEC2Config { // Specify the endpoint explicitly ServiceURL = "https://ec2.us-west-new.amazonaws.com" }; using (var ec2Client = new AmazonEC2Client(ec2ClientConfig)) { // Make a request to EC2 in the new Region using ec2Client }

すべてのサービスクライアント用にリージョンを指定する

アプリケーションによって作成されるすべての AWS サービスクライアント用にリージョンを指定する方法は複数あります。このリージョンは、特定のリージョンを使用して作成されていないサービスクライアントに使用されます。

AWS SDK for .NET は、以下の順序でリージョン値を検索します。

プロファイル

アプリケーションまたは SDK によってロードされたプロファイルを設定します。詳細については、「認証情報とプロファイルの解決」を参照してください。

環境変数

以下のように AWS_REGION 環境変数を設定します。

Linux または macOS の場合:

export AWS_REGION='us-west-2'

Windows の場合:

set AWS_REGION=us-west-2
注記

この環境変数をシステム全体に設定すると (export または setx を使用)、AWS SDK for .NET だけではなく、すべての SDK とツールキットが影響を受けます。

AWSConfigs クラス

以下のように AWSConfigs.AWSRegion プロパティとして設定します。

AWSConfigs.AWSRegion = "us-west-2"; using (var ec2Client = new AmazonEC2Client()) { // Make request to Amazon EC2 in us-west-2 Region using ec2Client }

リージョン解像度

AWS リージョン の指定に上記のいずれの方法も使用されない場合、AWS SDK for .NET は AWS サービス クライアントが動作するリージョンを見つけようとします。

リージョン解像度オーダー
  1. app.configweb.configなどのアプリケーション設定ファイル。

  2. 環境変数(AWS_REGIONおよびAWS_DEFAULT_REGION

  3. の値で指定された名前のプロファイル。

  4. AWS_PROFILE 環境変数で指定された名前を持つプロファイル。

  5. [default]プロファイル。

  6. Amazon EC2 インスタンスのメタデータ (EC2 インスタンスで実行されている場合)。

リージョンが見つからない場合、SDKは、 AWS サービスクライアントにリージョンが設定されていないことを示す例外を投げます。

中国 (北京) リージョンに関する特別な情報

中国 (北京) リージョンでサービスを使用するには、中国 (北京) リージョン固有のアカウントと認証情報が必要です。他の AWS リージョンのアカウントと認証情報は、中国 (北京) リージョンでは使用できません。同様に、中国 (北京) リージョンのアカウントと認証情報は他の AWS リージョンでは使用できません。中国 (北京) リージョンで利用可能なエンドポイントとプロトコルの詳細については、「北京リージョンのエンドポイント」を参照してください。

新しい AWS サービスに関する新しい特別な情報

新しい AWS のサービスは、最初にいくつかのリージョンで開始された後で、他のリージョンでサポートされます。このような場合、そのサービス用の新しいリージョンにアクセスするために最新の SDK をインストールする必要はありません。新しく追加されたリージョンは、前述したように、クライアントごと、またはグローバルに指定できます。