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

# 指定 AWS CodeBuild 端點
<a name="endpoint-specify"></a>

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

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

**注意**  
 您可以使用別名或區域名稱，使用 AWS SDK 指定端點。如果您使用 AWS CLI，則必須使用完整的端點名稱。

 如需可與 CodeBuild 搭配使用的端點，請參閱 [CodeBuild 區域和端點](https://docs.aws.amazon.com/general/latest/gr/rande.html#codebuild_region)。

**Topics**
+ [指定 AWS CodeBuild 端點 (AWS CLI)](#endpoint-specify-cli)
+ [指定 AWS CodeBuild 端點 (AWS SDK)](#endpoint-specify-sdk)

## 指定 AWS CodeBuild 端點 (AWS CLI)
<a name="endpoint-specify-cli"></a>

 您可以使用 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 命令參考](https://docs.aws.amazon.com/cli/latest/reference/)。

## 指定 AWS CodeBuild 端點 (AWS SDK)
<a name="endpoint-specify-sdk"></a>

 您可以使用 AWS SDK 來指定透過 AWS CodeBuild 存取的端點。雖然此範例使用[AWS 適用於 Java 的 開發套件](https://aws.amazon.com/sdk-for-java/)，但您可以使用其他 AWS SDKs指定端點。

 建構 AWSCodeBuild 用戶端時，請使用 `withEndpointConfiguration` 方法。這是要使用的格式：

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

 如需有關 `AWSCodeBuildClientBuilder` 的詳細資訊，請參閱 [Class AWSCodeBuildClientBuilder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/codebuild/AWSCodeBuildClientBuilder.html)。

 `withCredentials` 中使用之登入資料的類型必須是 `AWSCredentialsProvider`。如需詳細資訊，請參閱[使用 AWS 登入](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials.html)資料。

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

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

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

下表列出四個可用之 FIPS 端點的別名：


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/endpoint-specify.html)

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