Amazon S3 接入点
注意
如需获得相关帮助，以了解设置页面的布局或解释后面的 Amazon SDK 和工具支持表，请参阅了解本指南的设置页面。
Amazon S3 服务提供接入点作为与 Amazon S3 存储桶交互的替代方式。接入点上可以应用唯一的策略和配置，而不是直接应用到存储桶。使用 Amazon SDK，您可以在存储桶字段中使用接入点 Amazon 资源名称（ARN）进行 API 操作，而不必明确指定存储桶名称。它们用于特定的操作，例如使用具有 GetObject 的接入点 ARN 从存储桶中获取对象，或者使用具有 PutObject 的接入点 ARN 将对象添加到存储桶。
要了解有关 Amazon S3 接入点和 ARN 的更多信息，请参阅 Amazon S3 用户指南中的使用接入点。
使用以下方法配置此功能：
s3_use_arn_region- 共享 Amazonconfig文件设置AWS_S3_USE_ARN_REGION- 环境变量aws.s3UseArnRegion：JVM 系统属性，仅适用于 Java/Kotlin- 要直接在代码中配置值，请直接查阅您的特定 SDK。
-
此设置控制 SDK 是否使用接入点 ARN Amazon Web Services 区域为请求构造区域端点。SDK 会验证 ARN Amazon Web Services 区域是否由与客户端配置的 Amazon Web Services 区域相同的 Amazon 分区提供服务，以防止很有可能失败的跨分区调用。如果多次定义，则优先使用代码配置的设置，其次是环境变量设置。
默认值：
false有效值：
-
true– SDK 在构造端点时使用 ARN Amazon Web Services 区域，而不是客户端配置的 Amazon Web Services 区域。例外：如果客户端配置的 Amazon Web Services 区域 是 FIPS Amazon Web Services 区域，则它必须与 ARN 的 Amazon Web Services 区域 相匹配。否则将导致出现错误。 -
false– SDK 在构造端点时使用客户端配置的 Amazon Web Services 区域。
-
Amazon SDK 和工具支持
以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。任何 JVM 系统属性设置都仅支持 适用于 Java 的 Amazon SDK 和 适用于 Kotlin 的 Amazon SDK。
| SDK | 支持 | 备注或更多信息 |
|---|---|---|
| Amazon CLI v2 | 是 | |
| 适用于 C++ 的 SDK | 是 | |
| 适用于 Go V2 (1.x) 的 SDK |
是 | |
| 适用于 Go 1.x（V1）的 SDK | 是 | 要使用共享 config 文件设置，必须开启从配置文件加载的功能；请参阅会话。 |
| 适用于 Java 2.x 的 SDK | 是 | |
| 适用于 Java 1.x 的 SDK | 是 | 不支持 JVM 系统属性。 |
| 适用于 JavaScript 3.x 的 SDK | 是 | |
| 适用于 JavaScript 2.x 的 SDK | 是 | |
| 适用于 Kotlin 的 SDK | 是 | |
| 适用于 .NET 4.x 的 SDK | 是 | |
| 适用于 .NET 3.x 的 SDK | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 |
| 适用于 PHP 3.x 的 SDK | 是 | |
| 适用于 Python (Boto3) 的 SDK |
是 | |
| 适用于 Ruby 3.x 的 SDK | 是 | |
| 适用于 Rust 的 SDK | 否 | |
| 适用于 Swift 的 SDK | 否 | |
| Tools for PowerShell V5 | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 |
| Tools for PowerShell V4 | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 |