本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon S3 存取點
注意
如需了解設定頁面配置或解譯 Support AWS SDKs和後續工具資料表的說明，請參閱 了解本指南的設定頁面。
Amazon S3 服務提供存取點做為與 Amazon S3 儲存貯體互動的替代方式。存取點具有可套用至它們的唯一政策和組態，而不是直接套用至儲存貯體。透過 AWS SDKs，您可以在儲存貯體欄位中使用存取點 Amazon Resource Name (ARNs) 進行 API 操作，而不是明確指定儲存貯體名稱。它們用於特定操作，例如使用存取點 ARN GetObject搭配 從儲存貯體擷取物件，或使用存取點 ARN 搭配 PutObject 將物件新增至儲存貯體。
若要進一步了解 Amazon S3 存取點和 ARNs，請參閱《Amazon S3 使用者指南》中的使用存取點。
使用下列設定此功能：
s3_use_arn_region- 共用 AWSconfig檔案設定AWS_S3_USE_ARN_REGION- 環境變數aws.s3UseArnRegion- JVM 系統屬性：僅限 Java/Kotlin- 若要直接在程式碼中設定值，請直接參閱您的特定 SDK。
-
此設定會控制 SDK 是否使用存取點 ARN AWS 區域 來建構請求的區域端點。軟體開發套件會驗證 ARN 是否由與用戶端設定的相同 AWS 分割區 AWS 區域 提供 AWS 區域 ，以防止很可能失敗的跨分割區呼叫。如果定義了乘法，則程式碼設定的設定優先，後面接著環境變數設定。
預設值：
false有效值：
-
true– SDK 會在建構端點 AWS 區域 時使用 ARN，而不是用戶端的設定 AWS 區域。例外狀況：如果用戶端的 設定為 AWS 區域 FIPS AWS 區域，則必須符合 ARN 的 AWS 區域。否則將會發生錯誤。 -
false– SDK 會在建構端點時使用用戶端的 設定 AWS 區域 。
-
支援 AWS SDKs和工具
下列 SDKs 支援本主題中所述的功能和設定。會記下任何部分例外狀況。 AWS SDK for Java 和 適用於 Kotlin 的 AWS SDK 僅支援任何 JVM 系統屬性設定。
| SDK | 支援 | 備註或更多資訊 |
|---|---|---|
| AWS CLI v2 | 是 | |
| 適用於 C++ 的 SDK | 是 | |
| SDK for Go V2 (1.x) |
是 | |
| 適用於 Go 的 SDK 1.x (V1) | 是 | 若要使用共用config檔案設定，您必須開啟從組態檔案載入；請參閱工作階段。 |
| 適用於 Java 的 SDK 2.x | 是 | |
| 適用於 Java 的 SDK 1.x | 是 | 不支援 JVM 系統屬性。 |
| 適用於 JavaScript 3.x 的 SDK | 是 | |
| 適用於 JavaScript 2.x 的 SDK | 是 | |
| 適用於 Kotlin 的 SDK | 是 | |
| 適用於 .NET 3.x 的 SDK | 是 | 不遵循標準優先順序；共用config檔案值優先於環境變數。 |
| 適用於 PHP 3.x 的 SDK | 是 | |
| 適用於 Python 的 SDK (Boto3) |
是 | |
| 適用於 Ruby 的 SDK 3.x | 是 | |
| 適用於 Rust 的 SDK | 否 | |
| 適用於 Swift 的 SDK | 否 | |
| PowerShell 的工具 | 是 | 不遵循標準優先順序；共用config檔案值優先於環境變數。 |
