指定 AWS CodeBuild 端點

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

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

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

指定端點是選用的。如果您未明確告知 CodeBuild 要使用哪個端點，服務會使用與您 AWS 帳戶使用的區域相關聯的端點。CodeBuild 永遠不會預設為 FIPS 端點。如果您想要使用 FIPS 端點，則必須使用下列其中一種方法將 CodeBuild 與其建立關聯。

如需可與 CodeBuild 搭配使用的端點，請參閱 CodeBuild 區域和端點。

指定 AWS CodeBuild 端點 (AWS CLI)

您可以使用 AWS CLI 來指定端點，在任何 CodeBuild 命令中使用 AWS 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 SDK 來指定透過 AWS CodeBuild 存取的端點。雖然此範例使用AWS 適用於 Java 的 開發套件，但您可以使用其他 AWS SDKs指定端點。

建構 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 端點的別名：

若要使用別名指定在美國西部 （奧勒岡） 區域中使用 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();