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