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

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

指定 Amazon CodeBuild 终端节点

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

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

注意

您可以使用 S Amazon DK 使用别名或区域名称来指定终端节点。如果您使用 Amazon CLI,则必须使用终端节点的完整名称。

有关可与之配合使用的终端节点 CodeBuild,请参阅CodeBuild 区域和终端节点

指定 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 SDK)

您可以使用 S Amazon DK 来指定访问的终端节点。 Amazon CodeBuild 尽管此示例使用Amazon 适用于 Java 的 SDK,但您可以使用另一个示例指定终端节点 Amazon SDKs。

在构建 B AWSCode uild 客户端时使用该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();