本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
指定 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 开发工具包
构造 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();