本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

 您可以使用 AWS Command Line Interface (AWS CLI) 或其中一个 AWS 软件开发工具包来指定使用的 AWS CodeBuild终端节点。每个可用区域都有一个终端节点。 CodeBuild 除了一个区域端点之外，四个区域还有联邦信息处理标准 (FIPS) 端点。有关联邦信息处理标准端点的更多信息，请参阅 [FIPS 140-2 概述](https://aws.amazon.com/compliance/fips/)。

 可以选择指定端点。如果您没有明确说明要使用 CodeBuild 哪个终端节点，则该服务将使用与您的 AWS 账户使用的区域关联的终端节点。 CodeBuild从不默认为 FIPS 端点。如果您希望使用 FIPS 终端节点，则必须使用以下方法之一将 CodeBuild 与其关联。

**注意**  
 您可以使用 S AWS DK 使用别名或区域名称来指定终端节点。如果您使用 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>

 您可以通过在任何 CodeBuild 命令中使用`--endpoint-url`参数 AWS CLI 来指定访问的终端节点。 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 命令参考](https://docs.aws.amazon.com/cli/latest/reference/)。

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

 您可以使用 S AWS DK 来指定访问的终端节点。 AWS CodeBuild 尽管此示例使用适用于 [Java 的AWS SDK](https://aws.amazon.com/sdk-for-java/)，但您可以使用其他 AWS SDK 来指定终端节点。

 在构造 AWSCodeBuild 客户端时使用该`withEndpointConfiguration`方法。下面是使用的格式：

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

 有关的信息`AWSCodeBuildClientBuilder`，请参见[类 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 端点的各自的别名。


****  

| 区域名称 | 区域 | 端点 | Alias | 
| --- | --- | --- | --- | 
| 美国东部（弗吉尼亚州北部） | 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();
```