本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
指定 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
建構 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();