本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon S3 接入点
Amazon S3 服务提供接入点作为与 Amazon S3 存储桶交互的替代方式。接入点上可以应用唯一的策略和配置,而不是直接应用到存储桶。使用 Amazon 软件开发工具包,您可以在存储桶字段中使用接入点 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 会验证 Amazon Web Services 区域 ARN 是否由与客户端 Amazon Web Services 区域 配置 Amazon 相同的分区提供服务,以防止最有可能失败的跨分区调用。如果多次定义,则优先使用代码配置的设置,其次是环境变量设置。
默认值:
false
有效值:
-
true
— SDK 在构造终端节点 Amazon Web Services 区域 时使用 ARN,而不是客户端的配置 Amazon Web Services 区域。例外:如果客户端的配置 Amazon Web Services 区域 是 FIPS Amazon Web Services 区域,则它必须与 ARN 相匹配。 Amazon Web Services 区域否则将导致出现错误。 -
false
– SDK 在构造端点时使用客户端配置的 Amazon Web Services 区域 。
-
与 Amazon SDK 的兼容性
以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。 Amazon SDK for Java 和 Amazon SDK for Kotlin 唯一支持任何 JVM 系统属性设置。
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 | 支持 | |
适用于 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 | 不支持 | |
用于 PowerShell | 支持 | 不遵循标准优先级;共享的config 文件值优先于环境变量。 |