指定 AWS CodeBuild 终端节点 - AWS CodeBuild

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

指定 AWS CodeBuild 终端节点

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

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

注意

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

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

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

您可以通过在任何 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 命令参考

指定 AWS CodeBuild 终端节点 (AWS SDK)

您可以使用 AWS SDK来指定通过哪 AWS CodeBuild 个端点进行访问。尽管此示例使用 f AWS SDKor Java 的,但您可以用另一个来指定终端节点 AWS SDKs。

在构造 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-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();