基于账户的端点
注意
如需获得相关帮助,以了解设置页面的布局或解释后面的 Amazon SDK 和工具支持表,请参阅了解本指南的设置页面。
基于账户的端点通过使用 Amazon Web Services 账户 ID 来为支持此功能的服务路由请求,有助于确保高性能和可扩展性。使用支持基于账户的端点的 Amazon SDK 和服务时,SDK 客户端会构造和使用基于账户的端点,而不是区域性端点。如果 SDK 客户端看不到账户 ID,则该客户端将使用区域性端点。基于账户的端点格式为 https://,其中 <account-id>.ddb.<region>.amazonaws.com 和 <account-id> 是您的 Amazon Web Services 账户 ID 和 Amazon Web Services 区域。<region>
使用以下方法配置此功能:
aws_account_id- 共享 Amazonconfig文件设置AWS_ACCOUNT_ID- 环境变量aws.accountId:JVM 系统属性,仅适用于 Java/Kotlin-
Amazon Web Services 账户 ID。用于基于账户的端点路由。Amazon Web Services 账户 ID 的格式类似于 111122223333。
对于某些服务,基于账户的端点路由可提高请求性能。
account_id_endpoint_mode- 共享 Amazonconfig文件设置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。
| SDK | 支持 | 发布此功能的 SDK 版本 | 备注或更多信息 |
|---|---|---|---|
| Amazon CLI v2 | 是 | 2.25.0 | |
| Amazon CLI v1 | 是 | 1.38.0 | |
| 适用于 C++ 的 SDK | 否 | ||
| 适用于 Go V2 (1.x) 的 SDK |
是 | v1.35.0 | |
| 适用于 Go 1.x(V1)的 SDK | 否 | ||
| 适用于 Java 2.x 的 SDK | 是 | v2.28.4 | |
| 适用于 Java 1.x 的 SDK | 是 | v1.12.771 | |
| 适用于 JavaScript 3.x 的 SDK | 是 | v3.656.0 | |
| 适用于 JavaScript 2.x 的 SDK | 否 | ||
| 适用于 Kotlin 的 SDK | 是 | v1.3.37 | |
| 适用于 .NET 4.x 的 SDK | 是 | 4.0.0 | |
| 适用于 .NET 3.x 的 SDK | 否 | ||
| 适用于 PHP 3.x 的 SDK | 是 | v3.318.0 | |
| 适用于 Python (Boto3) 的 SDK |
是 | 1.37.0 | |
| 适用于 Ruby 3.x 的 SDK | 是 | v1.123.0 | |
| 适用于 Rust 的 SDK | 否 | ||
| 适用于 Swift 的 SDK | 是 | 1.2.0 | |
| Tools for PowerShell V5 | 否 | ||
| Tools for PowerShell V4 | 否 |