AWS CodeBuild エンドポイントの指定

AWS Command Line Interface で使用するエンドポイントを指定するには、AWS CLI (AWS)、または AWS CodeBuild SDK を使用します。エンドポイントは、CodeBuild が使用可能なリージョンごとに存在します。リージョンのエンドポイントに加えて、4 つのリージョンに連邦情報処理標準 (FIPS) エンドポイントがあります。FIPS エンドポイントの詳細については、「FIPS 140-2 の概要」を参照してください。

エンドポイントの指定はオプションです。使用するエンドポイントを CodeBuild で明示的に指定しない場合、このサービスでは、AWS アカウントで使用しているリージョンに関連付けられているエンドポイントが使用されます。CodeBuild では、FIPS エンドポイントがデフォルトで使用されることはありません。FIPS エンドポイントを使用するには、次のいずれかのメソッドを使用して、CodeBuild と関連付ける必要があります。

注記

AWS SDK を使用してエンドポイントを指定するには、エイリアスまたはリージョン名を使用します。AWS CLI を使用する場合は、完全なエンドポイント名を使用する必要があります。

CodeBuild で使用可能なエンドポイントについては、「CodeBuild のリージョンとエンドポイント」を参照してください。

AWS CodeBuild エンドポイントの指定 (AWS CLI)

AWS CLI を使用して、AWS CodeBuild にアクセスするエンドポイントを指定するには、CodeBuild コマンドに --endpoint-url 引数を指定します。たとえば、「米国東部 (バージニア北部) リージョン」で連邦情報処理標準 (FIPS) エンドポイントを使用して、プロジェクトビルド名のリストを取得するには、このコマンドを実行します。

aws codebuild list-projects --endpoint-url https://codebuild-fips.us-east-1.amazonaws.com

エンドポイントの先頭に https:// を追加します。

--endpoint-url の AWS CLI 引数は、すべての AWS サービスに利用できます。この引数と AWS CLI の引数については、AWS CLI コマンドリファレンスを参照してください。

AWS CodeBuild エンドポイントの指定 (AWS SDK)

AWS にアクセスするエンドポイントを指定するには、AWS CodeBuild SDK を使用します。この例では、「AWS SDK for Java」が使用されていますが、他の AWS SDK を使用してエンドポイントを指定することもできます。

AWSCodeBuild クライアントを作成する場合は、withEndpointConfiguration メソッドを使用します。以下の形式を使用します。

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
    withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("endpoint", "region")).
    withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
    build();
        

AWSCodeBuildClientBuilder については、「AWSCodeBuildClientBuilder クラス」を参照してください。

withCredentials の認証情報のタイプは、AWSCredentialsProvider を使用する必要があります。詳細については、「AWS 認証情報の使用」を参照してください。

エンドポイントの先頭に https:// を追加しないでください。

非 FIPS エンドポイントを指定する場合は、実際のエンドポイントではなくリージョンを使用します。例えば、米国東部 (バージニア北部) リージョンのエンドポイントを指定するには、完全なエンドポイント名 (codebuild.us-east-1.amazonaws.com) ではなく、us-east-1 を使用できます。

FIPS エンドポイントを指定する場合は、エイリアスを使用して、コードを簡素化することができます。FIPS エンドポイントのみ、エイリアスが含まれます。他のエンドポイントは、リージョンまたは完全名を使用して指定する必要があります。

利用できる 4 つの FIPS エンドポイントごとのエイリアスを以下のテーブルに示します。

リージョン名	リージョン	エンドポイント	エイリアス
米国東部 (バージニア北部)	us-east-1	codebuild-fips.us-east-1.amazonaws.com	us-east-1-fips
米国東部 (オハイオ)	us-east-2	codebuild-fips.us-east-2.amazonaws.com	us-east-2-fips
米国西部 (北カリフォルニア)	us-west-1	codebuild-fips.us-west-1.amazonaws.com	us-west-1-fips
米国西部 (オレゴン)	us-west-2	codebuild-fips.us-west-2.amazonaws.com	us-west-2-fips

エイリアスを使用して、米国西部 (オレゴン) リージョンの FIPS エンドポイントを指定するには:

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
    withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("us-west-2-fips", "us-west-2")).
    withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
    build();
    

米国東部 (バージニア北部) リージョンの非 FIPS エンドポイントを指定するには:

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
    withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("us-east-1", "us-east-1")).
    withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
    build();
    

アジアパシフィック (ムンバイ) リージョンの非 FIPS エンドポイントを指定するには:

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
    withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("ap-south-1", "ap-south-1")).
    withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
    build();