AWS リージョン の の設定 AWS SDK for Java 2.x - AWS SDK for Java 2.x
AWS リージョンを明示的に設定する環境からリージョンを決定するサービス可用性を確認する特定のエンドポイントを選択する

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

AWS リージョン の の設定 AWS SDK for Java 2.x

SDK クライアントは、クライアントの作成時に AWS リージョン 指定した特定の AWS のサービス の に接続します。この設定により、アプリケーションはその地理的エリアのリソースと AWS やり取りできます。リージョンを明示的に設定せずにサービスクライアントを作成すると、SDK は外部設定からデフォルトのリージョンを使用します。

AWS リージョンを明示的に設定する

リージョンを明示的に設定するには、Region クラスで定義されている定数を使用することをお勧めします。これは、公開されている利用可能なすべてのリージョンを列挙したものです。

そのクラスで列挙されたリージョンが設定されたクライアントを作成するには、クライアントビルダーの region メソッドを使用します。

Ec2Client ec2 = Ec2Client.builder()
          .region(Region.US_WEST_2)
          .build();

使用するリージョンが Region クラスの列挙でない場合は、静的な of メソッドを使用して新しいリージョンを作成することができます。このメソッドを使用することで、SDK をアップグレードせずに、新しいリージョンにアクセスすることができます。

Region newRegion = Region.of("us-east-42");
Ec2Client ec2 = Ec2Client.builder()
          .region(newRegion)
          .build();
注記

ビルダーを使用してクライアントを構築すると、そのクライアントはイミュータブルになり、 AWS リージョン は変更できません。同じサービス AWS リージョン で複数の を使用する必要がある場合は、リージョンごとに 1 つずつ、複数のクライアントを作成する必要があります。

SDK が環境 AWS リージョン からデフォルトを自動的に決定できるようにする

コードが Amazon EC2 または で実行されている場合 AWS Lambda、コードが実行されている AWS リージョン のと同じ を使用するようにクライアントを設定することもできます。これにより、コードが実行中の環境から切り離され、レイテンシーや冗長性を低く AWS リージョン するためにアプリケーションを複数の にデプロイすることが容易になります。

デフォルトの AWS リージョン プロバイダーチェーンを使用して環境からリージョンを決定するには、クライアントビルダーの createメソッドを使用します。

Ec2Client ec2 = Ec2Client.create();

他の方法でクライアントを設定することもできますが、リージョンを設定することはできません。SDK は、デフォルトのリージョンプロバイダーチェーン AWS リージョン を使用して を取得します。

Ec2Client ec2Client = Ec2Client.builder()
        .credentialsProvider(ProfileCredentialsProvider.builder()
                .profileName("my-profile")
                .build())
        .build();

region メソッド AWS リージョン を使用して を明示的に設定しない場合、SDK はデフォルトのリージョンプロバイダーチェーンを参照して、使用するリージョンを決定します。

デフォルトの AWS リージョン プロバイダーチェーンについて

SDK は次の手順で AWS リージョンを検索します。

  1. ビルダー自体で regionメソッドを使用して設定された明示的なリージョンは、他のものよりも優先されます。

  2. SDK は JVM システムプロパティを検索aws.regionし、見つかった場合はその値を使用します。

  3. AWS_REGION 環境変数が確認されます。設定されている場合は、そのリージョンを使用してクライアントが設定されます。

    注記

    Lambda コンテナはこの環境変数を設定します。

  4. SDK は、AWS 共有設定ファイルと認証情報ファイル内のアクティブなプロファイルをチェックします。region プロパティが存在する場合、SDK はそれを使用します。

    default プロファイルは、AWS_PROFILE環境変数または aws.profile JVM システムプロパティによって上書きされない限り、アクティブなプロファイルです。SDK が同じプロファイル ( プロファイルを含むdefault) の両方のファイルで regionプロパティを見つけた場合、SDK は共有認証情報ファイルの 値を使用します。

  5. SDK は、 Amazon EC2 インスタンスメタデータサービス (IMDS) を使用して、現在実行中 Amazon EC2 のインスタンスのリージョンを決定しようとします。

    • セキュリティを強化するには、SDK がバージョン 1 の IMDS を使用しようとしないようにする必要があります。同じ設定を使用して、 IAM ロールの認証情報を安全に取得するセクションで説明されているバージョン 1 を無効にします。

  6. この時点で SDK によってリージョンがまだ見つかっていない場合は、クライアント作成が失敗し、例外が発生します。

AWS アプリケーションを開発する場合の一般的なアプローチは、共有設定ファイルを使用してローカル開発用のリージョンを設定し、デフォルトのリージョンプロバイダーチェーンを使用して、アプリケーションが AWS インフラストラクチャ上で実行されるときにリージョンを決定することです。これによって、クライアントの作成が大幅に簡略化され、アプリケーションの性が維持されます。

リージョンでサービスが使用可能かどうかを確認する

特定の AWS のサービス がリージョンで使用可能かどうかを確認するには、サービスクライアントで静的serviceMetadataメソッドを使用します。

DynamoDbClient.serviceMetadata().regions().forEach(System.out::println);

前のスニペットは、DynamoDB サービスを持つ AWS リージョン コードの長いリストを出力します。

af-south-1
ap-east-1
ap-northeast-1
ap-northeast-2
ap-northeast-3
ap-south-1
ap-south-2
ap-southeast-1
...

コードを使用して、サービスクライアントが使用するリージョンのリージョンクラスの列挙を検索できます。

たとえば、コード を使用して リージョンで DynamoDB を操作する場合はap-northeast-2、少なくとも次の設定で DynamoDB クライアントを作成します。

DynamoDbClient ddb = DynamoDbClient.builder()
    .region(Region.AP_NORTHEAST_2)
    .build();

特定のエンドポイントを選択する

サービスのプレビュー機能を一般公開前にテストする場合など、特定の状況では、リージョン内の特定のエンドポイントを指定する必要がある場合があります。このような状況では、endpointOverride メソッドを呼び出してサービスクライアントを設定できます。

たとえば、特定のエンドポイントで欧州 (アイルランド) リージョンを使用するように Amazon EC2 クライアントを設定するには、次のコードを使用します。

Ec2Client ec2 = Ec2Client.builder()
               .region(Region.EU_WEST_1)
               .endpointOverride(URI.create("https://ec2.eu-west-1.amazonaws.com"))
               .build();

すべての AWS サービスのリージョンと対応するエンドポイントの現在のリストについては、「リージョンとエンドポイント」を参照してください。