View a markdown version of this page

一般的なリクエストヘッダー - Amazon Simple Storage Service

一般的なリクエストヘッダー

次の表では、さまざまなタイプの Amazon S3 REST リクエストで使用できるヘッダーについて説明します。

ヘッダー名 説明
Authorization

リクエスト認証に必要な情報。詳細については、「Amazon Simple Storage Service 開発者ガイド」の「認証ヘッダー」を参照してください。匿名リクエストの場合、このヘッダーは必要ありません。
Access-Control-Request-Method 事前 CORS リクエストとして送信される HTTP メソッドのリスト。事前 CORS 評価が成功すると、次の CORS リクエストで指定されたメソッドを使用できます。
Content-Length

RFC 2616 に基づくメッセージの長さ (ヘッダーなし)。このヘッダーは、ログ記録や ACL など、XML をロードする PUT およびオペレーションに必要です。
Content-Type

リクエストの本文にコンテンツがある場合のリソースのコンテンツタイプ。例:text/plain
Content-MD5

RFC 1864 に従ってメッセージの base64 エンコードされた 128 ビット MD5 ダイジェスト (ヘッダーなし)。このヘッダーをメッセージ整合性チェックとして使用し、データが最初に送信されたデータと同じであることを確認します。オプションですが、エンドツーエンドの整合性チェックとして Content-MD5 メカニズムを使用することをお勧めします。REST リクエスト認証の詳細については、「Amazon Simple Storage Service 開発者ガイド」の「REST 認証」を参照してください。
Date

Authorization ヘッダーに含める署名を作成するときに使用できる日付。Date ヘッダーを署名に使用する場合は、ISO 8601 基本形式で指定する必要があります。その場合、x-amz-date ヘッダーは必要ありません。x-amz-date が存在する場合は、常に Date ヘッダーの値よりも優先されることに注意してください。

Date ヘッダーを署名に使用しない場合は、RFC 2616 のセクション 3.3 に記載されている完全な日付の形式のいずれかを使用できます。例えば、Wed, 01 Mar 2006 12:00:00 GMT という日付/時間は、Amazon S3 で使用できる有効な日付/時間ヘッダーです。

Date ヘッダーを署名に使用する場合は、ISO 8601 基本形式の YYYYMMDD'T'HHMMSS'Z' で指定する必要があります。

Date が指定されていても、ISO 8601 基本形式でない場合は、x-amz-date ヘッダーも含める必要があります。Date を ISO 8601 基本形式で指定した場合は、署名リクエストに十分に対応できるため、x-amz-date ヘッダーは必要ありません。詳細については、「署名バージョン 4 の日付の処理」 (アマゾン ウェブ サービス用語集) を参照してください。
Expect

100-continue を使用しているアプリケーションは、確認を受け取るまでリクエスト本文を送信しません。ヘッダーに基づいてメッセージが拒否された場合、メッセージの本文は送信されません。このヘッダーは、本文を送信する場合にのみ使用できます。

有効な値: 100-continue
Host

パス形式のリクエストの場合、値は s3.amazonaws.com です。仮想形式のリクエストの場合、値は BucketName.s3.amazonaws.com です。詳細については、「Amazon Simple Storage Service ユーザーガイド」の「仮想ホスティング」を参照してください。

このヘッダーは HTTP 1.1 に必要です (ほとんどのツールキットではこのヘッダーが自動的に追加されます)。HTTP/1.0 リクエストではオプションです。
Origin

初期リクエスタのサーバー名を指定するエンドポイント。
x-amz-content-sha256

署名バージョン 4 を使用してリクエストを認証する場合、このヘッダーはリクエストペイロードのハッシュを提供します。詳細については、「Authorization ヘッダーの署名計算: 単一チャンクでのペイロードの転送 (AWS 署名バージョン 4)」を参照してください。オブジェクトをチャンクでアップロードする場合、署名がヘッダーのみを対象とし、ペイロードがないことを示す値を STREAMING-AWS4-HMAC-SHA256-PAYLOAD に設定します。詳細については、「Authorization ヘッダーの署名計算: 複数チャンクでのペイロードの転送 (チャンクアップロード) (AWS 署名バージョン 4)」を参照してください。
x-amz-date

Authorization ヘッダー内の署名を作成するときに使用される日付。ISO 8601 基本形式の YYYYMMDD'T'HHMMSS'Z' にする必要があります。例えば、20170210T120000Z という日付/時間は、Amazon S3 で使用できる有効な x-amz-date です。

x-amz-date はすべてのリクエストに対してオプションです。署名リクエストで使用する日付よりも優先される日付として使用できます。Date ヘッダーを ISO 8601 基本形式で指定した場合、x-amz-date は必要ありません。x-amz-date が存在する場合は、常に Date ヘッダーの値よりも優先されます。詳細については、「署名バージョン 4 の日付の処理」 (アマゾン ウェブ サービス用語集) を参照してください。
x-amz-security-token

このヘッダーは、以下のシナリオで使用できます。

  • Amazon DevPay オペレーションのセキュリティトークンを提供するには、Amazon DevPay を使用する各リクエストに 2 つの x-amz-security-token ヘッダーが必要です。1 つは製品トークン用、もう 1 つはユーザートークン用です。Amazon S3 は、認証されたリクエストを受信すると、計算した署名を提供された署名と比較します。署名の計算に使用される複数値ヘッダーの形式が正しくないと、認証の問題が発生する可能性があります。

  • 一時的なセキュリティ認証情報を使用する際にセキュリティトークンを提供するには – IAM から取得した一時的なセキュリティ認証情報を使用してリクエストを行う場合は、このヘッダーを使用してセキュリティトークンを提供する必要があります。一時的なセキュリティ認証情報の詳細については、「リクエストの作成」を参照してください。

このヘッダーは、Amazon DevPay を使用するリクエストと、一時的なセキュリティ認証情報を使用して署名されたリクエストに必要です。