このページは、ボールトと 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 ストレージクラスへの移行を検討してください。

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

ジョブの出力の取得 (GET output)

説明

このオペレーションでは、ジョブの開始 (ジョブの POST) を使用して開始したジョブの出力結果をダウンロードします。出力は、ジョブの開始時に指定したジョブタイプに応じて、アーカイブのコンテンツとボールトインベントリのいずれかとなります。

すべてのジョブの出力をダウンロードすることも、バイト範囲を指定して出力の一部をダウンロードすることもできます。アーカイブの取得ジョブでもインベントリの取得ジョブでも、ジョブの出力の取得レスポンスのヘッダーで返されたサイズとダウンロードされたサイズを比較して確認する必要があります。

アーカイブの取得ジョブでは、ダウンロードされたサイズが予期されたサイズであることも確認する必要があります。出力の一部をダウンロードする場合は、指定したバイト範囲が予期されるサイズとなります。たとえば、bytes=0-1048575 の範囲を指定した場合、ダウンロードサイズが 1,048,576 バイトであることを確認する必要があります。アーカイブ全体をダウンロードする場合は、予想サイズは Amazon Glacier にアップロードした際のアーカイブのサイズになります。予期されるサイズは、ジョブの出力の取得レスポンスのヘッダーでも返されます。

アーカイブの取得ジョブでは、指定したバイト範囲に応じて、Amazon Glacier によってデータの一部のチェックサムが返されます。ダウンロードしたデータが正しい部分であることを確認するには、クライアント側でチェックサムを計算し、値が一致していること、および予期されたサイズがダウンロードされていることを確認します。

ジョブ ID は、Amazon Glacier がジョブを完了してから少なくとも 24 時間は有効です。つまり、Amazon Glacier がジョブを完了してから 24 時間以内であれば、ジョブの出力をダウンロードできます。

リクエスト

構文

ジョブの出力を取得するには、特定のジョブの GET の URI に HTTP output リクエストを送信します。

GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Range: ByteRangeToRetrieve
x-amz-glacier-version: 2012-06-01

リクエストパラメータ

このオペレーションはリクエストパラメータを使用しません。

リクエストヘッダー

この操作では、すべての操作で共通のリクエストヘッダーに加えて、次のリクエストヘッダーを使用します。共通のリクエストヘッダーの詳細については、「一般的なリクエストヘッダー」を参照してください。

リクエスト本文

この操作にリクエストボディはありません。

レスポンス

構文

取得リクエストがジョブデータをすべて返す場合には、ジョブの出力レスポンスによってレスポンスコード 200 OK が返されます。リクエストで Range ヘッダーを指定するなど、コンテンツの一部をリクエストした場合には、レスポンスコード 206 Partial Content が返されます。

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: ContentType
Content-Length: Length
x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier

[Body containing job output.]

レスポンスヘッダー

レスポンス本文

Amazon Glacier は、レスポンス本文にジョブの出力を返します。出力は、ジョブのタイプに応じて、アーカイブのコンテンツとボールトインベントリのいずれかになります。ボールトインベントリの場合、デフォルトでは、インベントリのリストが以下の JSON 本文として返されます。

{
 "VaultARN": String,
 "InventoryDate": String,
 "ArchiveList": [
      {"ArchiveId": String,
       "ArchiveDescription": String,
       "CreationDate": String,
       "Size": Number,
       "SHA256TreeHash": String
      },
      ...
    ]
}

ボールトインベントリジョブの開始時に出力形式としてカンマ区切り値 (CSV) をリクエストした場合には、本文でボールトインベントリが CSV 形式で返されます。CSV 形式は "ArchiveId"、"ArchiveDescription"、"CreationDate"、"Size"、および "SHA256TreeHash" の 5 列で構成されます。定義は、対応する JSON フィールドと同じです。

JSON レスポンス本文には次の JSON フィールドが含まれています。

エラー

Amazon Glacier の例外とエラーメッセージについては、「エラーレスポンス」を参照してください。

例

以下の例は、アーカイブの取得ジョブのリクエストを示しています。

例 1: ダウンロードの出力

この例では、アーカイブの取得開始ジョブのリクエストに対するレスポンスとして Amazon Glacier によって作成されるデータを取得します。

リクエストの例

GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

レスポンスの例

以下は、アーカイブの取得ジョブに対するレスポンスの例です。Content-Type ヘッダーが application/octet-stream になっており、レスポンスに x-amz-sha256-tree-hash ヘッダーが含まれていることに注目してください。これは、ジョブデータがすべて返されることを示すものです。

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/octet-stream
Content-Length: 1048576

[Archive data.]

以下は、インベントリの取得ジョブに対するレスポンスの例です。Content-Type ヘッダーが application/json であることに注目してください。また、レスポンスには x-amz-sha256-tree-hash ヘッダーがありません。

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 906

{
 "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
 "InventoryDate": "2011-12-12T14:19:01Z",
 "ArchiveList": [
   {
     "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA",
     "ArchiveDescription": "my archive1",
     "CreationDate": "2012-05-15T17:19:46.700Z",
     "Size": 2140123,
     "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62"
   },
   {
     "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA",
     "ArchiveDescription": "my archive2",
     "CreationDate": "2012-05-15T17:21:39.339Z",
     "Size": 2140123,
     "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3"
   }
  ]
}

例 2: 出力の一部のみダウンロード

この例は、アーカイブの取得開始ジョブのリクエストに対するレスポンスとして Amazon Glacier が作成するアーカイブの一部のみを取得するものです。このリクエストでは、オプションの Range ヘッダーを使用して最初の 1,024 バイトのみを取得しています。

リクエストの例

GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Range: bytes=0-1023	
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

レスポンスの例

以下の正常なレスポンスは、206 Partial Content レスポンスを示しています。この例では、レスポンスに Amazon Glacier が返すバイト範囲を指定する Content-Range ヘッダーも含まれています。

HTTP/1.1 206 Partial Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Range: bytes 0-1023/8388608
Content-Type: application/octet-stream
Content-Length: 1024

[Archive data.]

関連するセクション