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

このページは、Vaults と 2012 年の元の REST API を使用する Amazon Glacier サービスの既存のお客様専用です。

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

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

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

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

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

ヘッダー名 説明 必須
Authorization

リクエストに署名するために必要なヘッダー。Amazon 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 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「」の形式である必要があります。リージョンは などの 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は 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)の場合は必須です。

条件付き