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

# Amazon S3 接入点
<a name="feature-s3-access-point"></a>

**注意**  
如需了解设置页面布局或解释后面的 Support b **y AWS SDKs 和 tools** 表格的帮助，请参阅[了解本指南的设置页面](settings-reference.md#settingsPages)。

Amazon S3 服务提供接入点作为与 Amazon S3 存储桶交互的替代方式。接入点上可以应用唯一的策略和配置，而不是直接应用到存储桶。使用 AWS SDKs，您可以在存储桶字段中使用接入点 Amazon 资源名称 (ARNs) 进行 API 操作，而不必明确指定存储桶名称。它们用于特定的操作，例如使用具有 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) 的接入点 ARN 从存储桶中获取对象，或者使用具有 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) 的接入点 ARN 将对象添加到存储桶。

要了解有关 Amazon S3 接入点的更多信息 ARNs，请参阅 *Amazon S3 用户指南*中的[使用接入点](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)。

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

**`s3_use_arn_region`-共享 AWS `config`文件设置`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 和工具
<a name="access-point-sdk-compat"></a>

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


| SDK | 支持 | 备注或更多信息 | 
| --- | --- | --- | 
| [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | 是 |  | 
| [适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | 是 |  | 
| [适用于 Go V2 (1.x) 的 SDK](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | 是 |  | 
| [适用于 Go 1.x（V1）的 SDK](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | 是 | 要使用共享 config 文件设置，必须开启从配置文件加载的功能；请参阅[会话](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/)。 | 
| [适用于 Java 2.x 的 SDK](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | 是 |  | 
| [适用于 Java 1.x 的 SDK](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | 是 | 不支持 JVM 系统属性。 | 
| [适用于 JavaScript 3.x 的软件开发工具包](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | 是 |  | 
| [适用于 JavaScript 2.x 的 SDK](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | 是 |  | 
| [适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | 是 |  | 
| [适用于.NET 4.x 的 SDK](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | 是 |  | 
| [适用于 .NET 3.x 的 SDK](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 | 
| [适用于 PHP 3.x 的 SDK](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | 是 |  | 
| [适用于 Python (Boto3) 的 SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | 是 |  | 
| [适用于 Ruby 3.x 的 SDK](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | 是 |  | 
| [适用于 Rust 的 SDK](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | 否 |  | 
| [适用于 Swift 的 SDK](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | 否 |  | 
| [适用于 PowerShell V5 的工具](https://docs.aws.amazon.com/powershell/latest/userguide/) | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 | 
| [适用于 PowerShell V4 的工具](https://docs.aws.amazon.com/powershell/v4/userguide/) | 是 | 不遵循标准优先顺序；共享的 config 文件值优先于环境变量。 |