S3 Express One Zone セッション認証 - AWS SDK とツール

S3 Express One Zone セッション認証

注記

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

S3 Express One Zone は頻繁にアクセスされるデータに対して 1 桁ミリ秒のレイテンシーを実現する、Amazon S3 の高性能ストレージクラスです。S3 Express One Zone バケットを使用すると、AWS SDK とツールは、データリクエストの低レイテンシー認可用に最適化されたセッションベースの認証を自動的に使用します。セッショントークンをゾーン (オブジェクトレベル) オペレーションで使用して認可関連のレイテンシーをセッション内の多数のリクエストに分散させることで、認証のオーバーヘッドが減少し、全体的なリクエストのパフォーマンスが向上します。

S3 Express One Zone バケットは、bucket-name--usw2-az1--x-s3 などのアベイラビリティーゾーン ID を含む特定の命名形式を使用します。SDK はこの命名パターンを検出すると、リクエストを適切な S3 Express One Zone エンドポイントに自動的にルーティングし、最適化された認証フローを適用します。セッション認証は、バケットへの低レイテンシーアクセスを実現する一時的なバケット固有の認証情報を作成し、SDK によって自動的にキャッシュおよび更新されます。詳細については、「Amazon S3 ユーザーガイド」の「S3 Express One Zone」を参照してください。

S3 Express One Zone バケットでは、セッション認証はデフォルトで有効になっています。

この機能を設定するには、以下のように使用します。

s3_disable_express_session_auth - AWS config 共有ファイル設定
AWS_S3_DISABLE_EXPRESS_SESSION_AUTH - 環境変数
aws.disableS3ExpressAuth - JVM システムプロパティ: Java/Kotlin のみ

S3 Express One Zone セッション認証を無効にするかどうかを制御します。true に設定すると、SDK はセッション認証の代わりに S3 Express One Zone バケットに標準 SigV4 認証を使用します。

デフォルト値: false

有効な値:

  • true – S3 Express One Zone セッション認証を無効にします。

  • false – S3 Express One Zone セッション認証を有効にします。

config ファイルにこの値を設定する例を以下に示します。

[default] s3_disable_express_session_auth=true

Linux/macOS のコマンドラインによる環境変数の設定の例を以下に示します。

export AWS_S3_DISABLE_EXPRESS_SESSION_AUTH=true

Windows のコマンドラインによる環境変数の設定の例を以下に示します。

setx AWS_S3_DISABLE_EXPRESS_SESSION_AUTH true

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

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

SDK サポート 注意または詳細情報
AWS CLI v2 あり
AWS CLI V1 なし
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 なし
SDK for JavaScript 3.x あり
SDK for JavaScript 2.x なし
SDK for Kotlin あり JVM システムプロパティは aws.s3DisableExpressSessionAuth です。
SDK for .NET 4.x あり
SDK for .NET 3.x あり
SDK for PHP 3.x あり
SDK for Python (Boto3) あり
SDK for Ruby 3.x あり
SDK for Rust あり
SDK for Swift あり
Tools for PowerShell V5 あり
Tools for PowerShell V4 あり