指定 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 來指定端點，透過該端點可在任何 CodeBuild 命令中使用 --endpoint-url 引數存取 AWS 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，請參閱類別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();
    

若要在美國東部 (維吉尼亞北部) 區域指定非 FIP 端點的使用：

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

若要在亞太區域 (孟買) 區域的非 FIP 端點的使用方式：

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