翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon S3 アクセスポイント
注記
設定ページのレイアウトの理解、または以下の Support by AWS SDKs「」を参照してくださいこのガイドの設定ページについて。
Amazon S3 サービスでは、Amazon S3 バケットを操作する代替方法としてアクセスポイントが使用できます。アクセスポイントには、バケットに直接ではなく、一意のポリシーと設定を適用できます。 AWS SDKs を使用すると、バケット名を明示的に指定する代わりに、バケットフィールドでアクセスポイントの Amazon リソースネーム (ARNs) を API オペレーションに使用できます。アクセスポイント ARN と GetObject
を使用してバケットからオブジェクトを取得したり、アクセスポイント ARN と PutObject
を使用してバケットにオブジェクトを追加したりするなど、特定の操作に使用されます。
Amazon S3 Access Points と ARN の詳細については、「Amazon S3 ユーザーガイド」の「アクセスポイントの使用」を参照してください。
この機能を設定するには、以下のように使用します。
s3_use_arn_region
- 共有 AWSconfig
ファイル設定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 | いいえ | |
SDK for Swift | いいえ | |
Tools for PowerShell | はい | 標準の優先順位には従いません。共有 config ファイルの値が環境変数よりも優先されます。 |