一般的なリクエストヘッダー - Amazon S3 Glacier

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

Amazon S3 Glacier (S3 Glacier) REST リクエストには、リクエストに関する基本的な情報を含むヘッダーが含まれています。次の表では、すべての S3 Glacier REST リクエストで使用できるヘッダーについて説明します。

ヘッダー名 説明 必須
Authorization

リクエストに署名するために必要なヘッダー。S3 Glacier では署名バージョン 4 が必要です。詳細については、「リクエストへの署名」を参照してください。

タイプ: 文字列

はい
Content-Length

リクエストボディの長さ (ヘッダー以外)。

タイプ: 文字列

条件: 場合にのみ必須です。アーカイブのアップロード (POST archive)API.

条件付き
Date

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

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

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

タイプ: 文字列

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

条件付き
Host

このヘッダーには、リクエストの送信先となるサービスエンドポイントを指定します。この値はという形式で指定する必要があります。glacier.region.amazonaws.com「という式を示します。リージョンに置き換えられます。AWSなどの地域指定us-west-2

タイプ: 文字列

はい
x-amz-content-sha256

アーカイブのアップロード (POST archive)またはパートのアップロード (PUT uploadID)でアップロードされるペイロード全体の計算された SHA256 チェックサム。このヘッダーは x-amz-sha256-tree-hash ヘッダーと同じではありませんが、一部の小さいペイロードについては値が同じになります。x-amz-content-sha256 が必要な場合は、x-amz-content-sha256x-amz-sha256-tree-hash の両方を指定する必要があります。

タイプ: 文字列

条件: ストリーミング API (アーカイブのアップロード (POST archive)およびパートのアップロード (PUT uploadID)

条件付き
x-amz-date

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

タイプ: 文字列

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

条件付き
x-amz-glacier-version

使用する S3 Glacier API バージョン。現在のバージョンは 2012-06-01 です。

タイプ: 文字列

はい
x-amz-sha256-tree-hash

アップロードしたアーカイブ (アーカイブのアップロード (POST archive)) またはアーカイブのパート (パートのアップロード (PUT uploadID)) の計算された SHA256 木構造ハッシュのチェックサム。このチェックサムの計算の詳細については、「チェックサムの計算」を参照してください。

タイプ: 文字列

デフォルト: なし

条件: では必須アーカイブのアップロード (POST archive)およびパートのアップロード (PUT uploadID)

条件付き