基于账户的端点 - AWS SDK 和工具

基于账户的端点

注意

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

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

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

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

AWS 账户 ID。用于基于账户的端点路由。AWS 账户 ID 的格式类似于 111122223333。

对于某些服务,基于账户的端点路由可提高请求性能。

account_id_endpoint_mode - 共享 AWS config 文件设置
AWS_ACCOUNT_ID_ENDPOINT_MODE - 环境变量
aws.accountIdEndpointMode:JVM 系统属性,仅适用于 Java/Kotlin

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

默认值:preferred

有效值:

  • preferred:端点应包含账户 ID(如果有)。

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

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

AWS SDK 和工具支持

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