指定 Amazon CodeBuild 终端节点 - Amazon CodeBuild
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

指定 Amazon CodeBuild 终端节点

您可以使用 Amazon Command Line Interface (Amazon CLI) 或 Amazon 开发工具包之一指定由 Amazon CodeBuild 使用的终端节点。CodeBuild 可用的每个区域都有一个终端节点。除了一个区域终端节点之外,四个区域还有联邦信息处理标准 (FIPS) 终端节点。有关 FIPS 终端节点的更多信息,请参阅 FIPS 140-2 概述

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

注意

您可以使用 Amazon 开发工具包,通过别名或区域名称指定终端节点。如果使用的是 Amazon CLI,则您必须使用终端节点的完整名称。

有关可用于 CodeBuild 的终端节点,请参阅CodeBuild 区域和终端节点.

指定 Amazon CodeBuild 终端节点 (Amazon CLI)

您可以使用Amazon CLI指定终端节点Amazon CodeBuild可以通过使用--endpoint-url任何 CodeBuild 命令中的参数。例如,运行此命令以获取在 US East (N. Virginia) 区域使用联邦信息处理标准 (FIPS) 终端节点的项目生成名称列表:

aws codebuild list-projects --endpoint-url https://codebuild-fips.us-east-1.amazonaws.com

在终端节点的开头包括 https://

--endpoint-url Amazon CLI 参数可供所有 Amazon 服务使用。有关此和其他的更多信息Amazon CLI参数,请参阅Amazon CLI命令参考.

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

您可以使用 Amazon 开发工具包指定访问 Amazon CodeBuild 时使用的终端节点。尽管此示例使用适用于 Java 的 Amazon 开发工具包,但是您可以指定具有其他 Amazon 开发工具包的终端节点。

构造 AWSCodeBuild 客户端时使用 withEndpointConfiguration 方法。下面是使用的格式:

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

有关 AWSCodeBuildClientBuilder 的信息,请参阅类 AWSCodeBuildClientBuilder

withCredentials 中使用的凭证的类型必须为 AWSCredentialsProvider。有关更多信息,请参阅使用 Amazon 凭证

不要在终端节点的开头包括 https://

如果您希望指定非 FIPS 终端节点,则可以使用区域而非实际终端节点。例如,要指定在 US East (N. Virginia) 区域中的终端节点,您可以使用us-east-1而不是终端节点的完整名称,codebuild.us-east-1.amazonaws.com.

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

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

区域名称 区域 Endpoint 别名
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

要指定使用美国西部(俄勒冈)区域中的 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();

指定使用亚太(孟买)区域中的非 FIPS 终端节点:

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