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

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

指定 Amazon CodeBuild 端点

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

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

注意

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

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

指定 Amazon CodeBuild 端点 (Amazon CLI)

您可以在任何 CodeBuild 命令中使用 --endpoint-url 参数,通过 Amazon CLI 指定访问 Amazon CodeBuild 时所用的端点。例如,运行此命令以获取在美国东部(弗吉尼亚州北部)中使用联邦信息处理标准 (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-1 而不是完整的端点名称 codebuild.us-east-1.amazonaws.com

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

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

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