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
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();