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

このページは、ボールトと 2012 年リリース当時の REST API を使用する、Amazon Glacier サービスの既存のお客様のみを対象としています。

アーカイブストレージソリューションをお探しの場合は、Amazon S3 の Amazon Glacier ストレージクラス (S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive) を使用することをお勧めします。これらのストレージオプションの詳細については、「Amazon Glacier ストレージクラス」を参照してください。

Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、新規顧客を受け入れなくなりました。Amazon Glacier は、ボールトにデータを保存する独自の API を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全性が確保され、引き続きアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は Amazon S3 Glacier ストレージクラス AWS を推奨します。これにより、S3 バケットベースの APIs、低コスト、 AWS サービス統合で優れたカスタマーエクスペリエンスを実現できます。 AWS リージョン 拡張機能が必要な場合は、Amazon Glacier ボールトから Amazon S3 Glacier ストレージクラスにデータを転送するためのAWS ソリューションガイダンスを使用して、Amazon S3 Glacier ストレージクラスへの移行を検討してください。

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

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

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

ヘッダー名 説明 必須
Authorization

リクエストに署名するために必要なヘッダー。Amazon Glacier には、Signature Version 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 GMT という日付/時間は、Amazon 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" にする必要があります (リージョンus-west-2 などの AWS リージョンの指定に置き換えます)。

タイプ: 文字列

あり
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 という日付/時間は、Amazon Glacier で使用できる有効な x-amz-date です。

タイプ: 文字列

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

条件付き
x-amz-glacier-version

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

タイプ: 文字列

あり
x-amz-sha256-tree-hash

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

タイプ: 文字列

デフォルト: なし

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

条件付き