AWS CodeBuild
用户指南 (API 版本 2016-10-06)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 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 区域和终端节点

指定 CodeBuild 终端节点 (AWS CLI)

您可以在任何 CodeBuild 命令中使用 --endpoint-url 参数,通过 AWS CLI 指定访问 AWS CodeBuild 时所用的终端节点。例如,运行此命令以获取在US East (N. Virginia) Region 中使用联邦信息处理标准 (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 Command Reference

指定 CodeBuild 终端节点(AWS 开发工具包)

您可以使用 AWS 开发工具包指定访问 AWS CodeBuild 时使用的终端节点。尽管此示例使用适用于 Java 的 AWS 开发工具包,但是您可以指定具有其他 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 (N. Virginia)区域中指定终端节点,您可以使用 us-east-1 而不是完整的终端节点名称 codebuild.us-east-1.amazonaws.com

如果您要指定 FIPS 终端节点,可以使用别名来简化代码。只有 FIPS 终端节点有别名。其他终端节点必须使用其区域或完整名称指定。

下表列出了四个可用 FIPS 终端节点的各自的别名。

区域名称 区域 终端节点 别名
US East (N. Virginia) us-east-1 codebuild-fips.us-east-1.amazonaws.com us-east-1-fips
US East (Ohio) us-east-2 codebuild-fips.us-east-2.amazonaws.com us-east-2-fips
US West (N. California) us-west-1 codebuild-fips.us-west-1.amazonaws.com us-west-1-fips
US West (Oregon) us-west-2 codebuild-fips.us-west-2.amazonaws.com us-west-2-fips

要指定使用US West (Oregon) 区域中的 FIPS 终端节点,请使用别名:

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

指定使用US East (N. Virginia) 区域中的非 FIPS 终端节点:

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

指定使用Asia Pacific (Mumbai) 区域中的非 FIPS 终端节点:

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