Amazon S3 接入点 - AWS SDKs和工具

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon S3 接入点

Amazon S3 服务提供接入点作为与 Amazon S3 存储桶交互的替代方式。接入点上可以应用唯一的策略和配置,而不是直接应用到存储桶。与 AWS SDKs,您可以在存储桶字段中使用访问点 Amazon 资源名称 (ARNs) 进行API操作,而不必明确指定存储桶名称。它们用于特定的操作,例如使用访问点ARN从存储桶中获取对象,或使用访问点ARN将对象PutObject添加到存储桶。GetObject

要了解有关 Amazon S3 接入点的更多信息ARNs,请参阅 Amazon S3 用户指南中的使用接入点

使用以下方法配置此功能:

s3_use_arn_region-共享 AWS config文件设置
AWS_S3_USE_ARN_REGION - 环境变量
aws.s3UseArnRegion-JVM 系统属性:仅限 Java/Kotlin
要直接在代码中配置值,请SDK直接咨询您的具体内容。

此设置控制是否SDK使用接入点 ARN AWS 区域 为请求构建区域终端节点。SDK验证了 ARN AWS 区域 由相同的方式提供 AWS 按照客户端的配置进行分区 AWS 区域 以防止最有可能失败的跨分区调用。如果多次定义,则优先使用代码配置的设置,其次是环境变量设置。

默认值false

有效值:

  • true— SDK 用途 t ARN he's AWS 区域 构造端点而不是客户端配置的端点时 AWS 区域。 例外:如果已配置客户端 AWS 区域 是一个 FIPS AWS 区域,那么它必须与 ARN's 匹配 AWS 区域。 否则,将导致错误。

  • false— SDK 使用客户端的配置 AWS 区域 在构造端点时。

兼容 AWS SDKs

以下内容SDKs支持本主题中描述的功能和设置。所有部分例外情况均已注明。支持任何JVM系统属性设置 AWS SDK for Java 还有 AWS SDK for Kotlin 只有。

SDK 支持 备注或更多信息
AWS CLI v2
SDK对于 C++
SDK适用于 Go V2 (1.x)
SDK适用于 Go 1.x (V1) 要使用共享 config 文件设置,必须开启从配置文件加载的功能;请参阅会话
SDK适用于 Java 2.x
SDK适用于 Java 1.x JVM不支持系统属性。
SDK适用于 JavaScript 3.x
SDK适用于 JavaScript 2.x
SDK对于 Kotlin 来说
SDK对于。 NET3.x 不遵循标准优先级;共享的config文件值优先于环境变量。
SDK适用于 PHP 3.x
SDK适用于 Python (Boto3)
SDK适用于 Ruby 3.x
SDK对于 Rust
SDK为斯威夫特
用于 PowerShell 不遵循标准优先级;共享的config文件值优先于环境变量。