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

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

基于账户的终端节点

基于账户的终端节点使用您的 Amazon Web Services 账户 ID 来简化支持此功能的服务 Amazon Web Services 服务 请求的路由,从而帮助确保高性能和可扩展性。当您使用支持基于账户的 Amazon SDK终端节点的凭证提供商和服务时,SDK将自动构建和使用基于账户的终端节点,而不是区域终端节点。基于账户的终端节点的形式为https://<account-id>.ddb.<region>.amazonaws.com,其中替换<account-id>为你的 Amazon Web Services 账户 ID,替换<region>为你的 ID Amazon Web Services 区域

默认情况下,账户 ID 是在处理请求时收集的,并用于构造终端节点。凭证解析也会在处理请求时发生,并且可能会更改端点解析的方法。根据您使用的凭证提供商,账户 ID 的来源可能有所不同。

使用以下方法配置此功能:

aws_account_id-共享 Amazon config文件设置
AWS_ACCOUNT_ID - 环境变量
aws.accountId-JVM 系统属性:仅限 Java/Kotlin

Amazon Web Services 账户 身份证。用于基于账户的端点路由。 Amazon Web Services 账户 身份证的格式类似于 111122223333。

基于账户的端点路由可为某些服务提供更好的请求性能。

account_id_endpoint_mode-共享 Amazon config文件设置
AWS_ACCOUNT_ID_ENDPOINT_MODE - 环境变量
aws.accountIdEndpointMode-JVM 系统属性:仅限 Java/Kotlin

此设置用于在必要时关闭基于账户的端点路由,并绕过基于账户的规则。

默认值preferred

有效值:

  • preferred— 端点应包括账户 ID(如果有)。

  • disabled— 已解析的端点不包含账户 ID。

  • required— 端点必须包含账户 ID。如果账户 ID 不可用,则会SDK引发错误。

兼容 Amazon SDKs

以下内容SDKs支持本主题中描述的功能和设置。所有部分例外情况均已注明。 Amazon SDK for Java 和 Amazon SDK for Kotlin 唯一支持任何JVM系统属性设置。