指定 AWS CodeBuild 端點 - AWS CodeBuild

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

指定 AWS CodeBuild 端點

您可以使用 AWS Command Line Interface (AWS CLI) 或其中一個 AWS 軟體開發套件來指定 AWS CodeBuild 使用的端點。每個區域都有一個端點,其中 CodeBuild 可供使用。除了區域端點,四個區域也會有聯邦資訊處理標準 (FIPS) 端點。如需 FIPS 端點的詳細資訊,請參閱 FIPS 140-2 概觀

指定端點是選用的。如果您未明確告知 CodeBuild 要使用的端點,服務會使用與AWS帳户使用。CodeBuild 永遠不會默認為 FIPS 終端節點。如果您要使用 FIPS 端點,您必須使用以下其中一個方法,將使用 CodeBuild 與它產生關聯。

注意

您可以使用別名或區域名稱,以使用 AWS 軟體開發套件指定端點。如果您使用 AWS CLI,則必須使用完整端點名稱。

如需可以與 CodeBuild 搭配使用的端點,請參閲CodeBuild 區域與端點

指定 AWS CodeBuild 端點 (AWS CLI)

您可以使用AWS CLI來指定端點AWS CodeBuild通過使用--endpoint-url參 CodeBuild。例如,運行此命令可獲取使用美國東部 (維吉尼亞北部) 區域的聯邦資訊處理標準 (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 開發套件)

您可以使用 AWS 軟體開發套件來指定端點,透過該端點存取 AWS CodeBuild。雖然此範例使用 AWS SDK for Java,但您可以使用其他 AWS 軟體開發套件來指定端點。

建構 AWSCodeBuild 用戶端時,請使用 withEndpointConfiguration 方法。這是要使用的格式:

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

如需有關 AWSCodeBuildClientBuilder 的詳細資訊,請參閱 Class AWSCodeBuildClientBuilder

withCredentials 中使用之登入資料的類型必須是 AWSCredentialsProvider。如需詳細資訊,請參閱使用 AWS 登入資料

請勿在端點的開頭包含 https://

如果您想要指定非 FIPS 端點,您可以使用區域而非實際端點。例如,若要指定美國東部 (維吉尼亞北部) 區域的端點,您可以使用us-east-1而不是完整的端點名稱codebuild.us-east-1.amazonaws.com

如果您想要指定 FIPS 端點,您可以使用別名來簡化程式碼。只有 FIPS 端點具有別名。其他端點必須使用其區域或完整名稱來指定。

下表列出四個可用之 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();