本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Amazon S3 接入点
注意
要帮助了解设置页面的布局或解释下方的 “ AWS SDK 和工具支持” 表格，请参阅了解本指南的设置页面。
Amazon S3 服务提供接入点作为与 Amazon S3 存储桶交互的替代方式。接入点上可以应用唯一的策略和配置，而不是直接应用到存储桶。使用 AWS 软件开发工具包，您可以在存储桶字段中使用接入点亚马逊资源名称 (ARN) 进行 API 操作，而不必明确指定存储桶名称。它们用于特定的操作，例如使用具有 GetObject 的接入点 ARN 从存储桶中获取对象，或者使用具有 PutObject 的接入点 ARN 将对象添加到存储桶。
要了解有关 Amazon S3 接入点和 ARN 的更多信息，请参阅 Amazon S3 用户指南中的使用接入点。
使用以下方法配置此功能：
s3_use_arn_region-共享 AWSconfig文件设置AWS_S3_USE_ARN_REGION- 环境变量aws.s3UseArnRegion-JVM 系统属性：仅限 Java/Kotlin- 要直接在代码中配置值，请直接查阅您的特定 SDK。
-
此设置控制 SDK 是否使用接入点 ARN AWS 区域 为请求构造区域终端节点。SDK 会验证 ARN AWS 区域 是否由与客户端配置的 AWS 分区相同的分区提供服务， AWS 区域 以防止跨分区调用很可能会失败。如果多次定义，则优先使用代码配置的设置，其次是环境变量设置。
默认值：
false有效值：
-
true— SDK 在构造端点 AWS 区域 时使用 ARN 而不是客户端配置 AWS 区域的 ARN。例外：如果客户端配置 AWS 区域 为 FIPS AWS 区域，则它必须与 ARN 相匹配。 AWS 区域否则将导致出现错误。 -
false– SDK 在构造端点时使用客户端配置的 AWS 区域 。
-
支持者 AWS SDK 和工具
以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。 适用于 Java 的 AWS SDK 和 适用于 Kotlin 的 AWS SDK 仅支持任何 JVM 系统属性设置。
| SDK | 支持 | 备注或更多信息 |
|---|---|---|
| AWS 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 软件开发工具包 | 是 | |
| 适用于 .NET 3.x 的 SDK | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 |
| 适用于 PHP 3.x 的 SDK | 是 | |
| 适用于 Python (Boto3) 的 SDK | 是 | |
| 适用于 Ruby 3.x 的 SDK | 是 | |
| 适用于 Rust 的 SDK | 否 | |
| 适用于 Swift 的 SDK | 否 | |
| PowerShell V5 工具 | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 |
| PowerShell V4 工具 | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 |
