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

基于账户的端点

注意

如需获得相关帮助,以了解设置页面的布局或解释后面的 Amazon SDK 和工具支持表,请参阅了解本指南的设置页面

基于账户的端点通过使用 Amazon Web Services 账户 ID 来为支持此功能的服务路由请求,有助于确保高性能和可扩展性。使用支持基于账户的端点的 Amazon SDK 和服务时,SDK 客户端会构造和使用基于账户的端点,而不是区域性端点。如果 SDK 客户端看不到账户 ID,则该客户端将使用区域性端点。基于账户的端点格式为 https://<account-id>.ddb.<region>.amazonaws.com,其中 <account-id><region> 是您的 Amazon Web Services 账户 ID 和 Amazon Web Services 区域。

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

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

Amazon Web Services 账户 ID。用于基于账户的端点路由。Amazon Web Services 账户 ID 的格式类似于 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 SDK 和工具支持

以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。任何 JVM 系统属性设置都仅支持 适用于 Java 的 Amazon SDK 和 适用于 Kotlin 的 Amazon SDK。