Amazon S3 アクセスポイント

Amazon S3 サービスでは、Amazon S3 バケットを操作する代替方法としてアクセスポイントが使用できます。アクセスポイントには、バケットに直接ではなく、一意のポリシーと設定を適用できます。 AWS SDKs では、バケット名を明示的に指定する代わりに、バケットフィールドのアクセスポイント Amazon リソースネーム (ARNsを 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 AWS リージョン は、ARN がクライアントの設定と同じ AWS パーティションによって処理されていることを検証 AWS リージョン し、ほとんどの場合失敗するパーティション間の呼び出しを防ぎます。複数定義した場合、コードで設定されたものが優先され、次に環境変数設定が続きます。

デフォルト値: false

有効値:

• true – SDK は、クライアントが設定した ではなく、エンドポイントを構築する AWS リージョン ときに ARN の を使用します AWS リージョン。例外: クライアントの AWS リージョン が FIPS に設定されている場合は AWS リージョン、ARN の と一致する必要があります AWS リージョン。そうしないと、エラーが発生します。

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

AWS SDKsとの互換性

以下の 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 3.x	はい	標準の優先順位には従いません。共有 config ファイルの値が環境変数よりも優先されます。
SDK for PHP 3.x	はい
SDK for Python (Boto3)	はい
SDK for Ruby 3.x	はい
SDK for Rust	いいえ
のツール PowerShell	はい	標準の優先順位には従いません。共有 config ファイルの値が環境変数よりも優先されます。