本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon S3 接入点
Amazon S3 服务提供接入点作为与 Amazon S3 存储桶交互的替代方式。接入点上可以应用唯一的策略和配置,而不是直接应用到存储桶。与 AWS SDKs,您可以在存储桶字段中使用访问点 Amazon 资源名称 (ARNs) 进行API操作,而不必明确指定存储桶名称。它们用于特定的操作,例如使用访问点ARN从存储桶中获取对象,或使用访问点ARN将对象PutObject
添加到存储桶。GetObject
要了解有关 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验证了 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 文件值优先于环境变量。 |