Amazon S3 アクセスポイント - AWS SDK とツール
AWS SDK とツールによるサポート

Amazon S3 アクセスポイント

注記

設定ページのレイアウトを理解したり、以下の AWS SDK とツールによるサポートの表を解釈したりするには、「このガイドの設定ページについて」を参照してください。

Amazon S3 サービスでは、Amazon S3 バケットを操作する代替方法としてアクセスポイントが使用できます。アクセスポイントには、バケットに直接ではなく、一意のポリシーと設定を適用できます。AWS SDK では、バケット名を明示的に指定するのではなく、バケットフィールドでアクセスポイントの Amazon リソースネーム (ARN) を API オペレーションに使用できます。アクセスポイント ARN と GetObject を使用してバケットからオブジェクトを取得したり、アクセスポイント ARN と PutObject を使用してバケットにオブジェクトを追加したりするなど、特定の操作に使用されます。

Amazon S3 Access Points と ARN の詳細については、「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 は、エンドポイントを構築するときに、クライアントで設定された AWS リージョン の代わりに ARN の AWS リージョン を使用します。例外：クライアントで設定された AWS リージョン が FIPS AWS リージョン の場合、ARN の AWS リージョン と一致する必要があります。そうしないと、エラーが発生します。

  • false – SDK は、エンドポイントを構築するときに、クライアントで設定された の代わりに ARN の AWS リージョン を使用します。

AWS SDK とツールによるサポート

以下の SDK は、このトピックで説明する機能と設定をサポートします。部分的な例外があれば、すべて記載されています。JVM システムプロパティ設定は、AWS SDK for Java と AWS SDK for Kotlin でのみサポートされます。

SDK サポート 注意または詳細情報
AWS CLI v2 あり
SDK for C++ あり
SDK for Go V2 (1.x) あり
SDK for Go 1.x (V1) あり 共有 config ファイル設定を使用するには、設定ファイルからの読み込みを有効にする必要があります。「セッション」を参照してください。
SDK for Java 2.x あり
SDK for Java 1.x あり JVM システムプロパティはサポートされていません。
SDK for JavaScript 3.x あり
SDK for JavaScript 2.x あり
SDK for Kotlin あり
SDK for .NET 4.x あり
SDK for .NET 3.x あり 標準の優先順位には従いません。共有 config ファイルの値が環境変数よりも優先されます。
SDK for PHP 3.x あり
SDK for Python (Boto3) あり
SDK for Ruby 3.x あり
SDK for Rust なし
SDK for Swift なし
Tools for PowerShell V5 あり 標準の優先順位には従いません。共有 config ファイルの値が環境変数よりも優先されます。
Tools for PowerShell V4 あり 標準の優先順位には従いません。共有 config ファイルの値が環境変数よりも優先されます。