Amazon Glacier でのボールトインベントリのダウンロード - 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 (Amazon Glacier) は自動的にボールトインベントリを作成し、1 日に約 1 回更新します。Amazon Glacier が最初のインベントリを作成した後、そのインベントリを取得できるようになるまでに通常半日から最大 1 日かかります。Amazon Glacier からボールトインベントリを取得するには、次の 2 つのステップを実行します。

  1. ジョブの開始 (ジョブの POST) オペレーションを使用して、インベントリの取得ジョブを開始します。

    重要

    データ取り出しポリシーにより、PolicyEnforcedException 例外が発生して、取り出しジョブの開始リクエストが失敗することがあります。データ取り出しポリシーの詳細については、「Amazon Glacier データ取得ポリシー」を参照してください。PolicyEnforcedException 例外の詳細については、「エラーレスポンス」を参照してください。

  2. ジョブが完了したら、ジョブの出力の取得 (GET output) オペレーションを使用してバイトをダウンロードします。

たとえば、アーカイブまたはボールトインベントリを取得するには、最初に取得ジョブを開始する必要があります。ジョブのリクエストは非同期的に実行されます。取得ジョブを開始すると、Amazon Glacier はジョブを作成し、レスポンスにジョブ ID を返します。Amazon Glacier がジョブを完了すると、ジョブ出力、アーカイブバイト、またはボールトインベントリデータを取得できます。

出力を取得する前にジョブが完了している必要があります。次のオプションを使用してジョブのステータスを確認できます。

  • ジョブ完了通知の待機 — ジョブの完了後に Amazon Glacier が通知を投稿できる Amazon Simple Notification Service (Amazon SNS) トピックを指定できます。以下のメソッドを使用して、Amazon SNS トピックを指定できます。

    • ジョブごとに Amazon SNS トピックを指定する。

      ジョブを開始する際に、オプションで Amazon SNS トピックを指定できます。

    • ボールトに通知設定を指定する。

      ボールトに特定のイベントに対する通知 設定を指定できます。(Amazon Glacier でのボールト通知の設定 を参照）。Amazon Glacier は、特定のイベントが発生するたびに、指定された SNS トピックにメッセージを送信します。

    ボールトに通知設定が設定されていて、ジョブの開始時に Amazon SNS トピックも指定している場合、Amazon Glacier は両方のトピックにジョブ完了メッセージを送信します。

    E メールで通知を受け取るか、アプリケーションがポーリングできる Amazon Simple Queue Service (Amazon SQS) にメッセージを格納するように SNS トピックを設定できます。メッセージがキューに表示されたら、ジョブが正常に完了したかどうかを確認し、ジョブの出力をダウンロードできます。

  • ジョブ情報を明示的にリクエストする — Amazon Glacier には、ジョブ情報をポーリングできるジョブ記述オペレーション (ジョブの説明 (GET JobID)) も用意されています。このリクエストを定期的に送信して、ジョブ情報を取得できます。ただし、Amazon SNS 通知を使用することをお勧めします。

注記

SNS 通知により取得する情報は、ジョブの説明を呼び出して取得する情報と同じです。

トピック

インベントリについて

Amazon Glacier は、アーカイブをボールトに初めてアップロードした日から、ボールトインベントリを少なくとも 1 日に 1 回更新します。最後のインベントリ以降に、ボールトに対してアーカイブの追加や削除が行われていない場合、インベントリの日付は更新されません。ボールトインベントリのジョブを開始すると、Amazon Glacier は最後に生成されたインベントリを返します。これはpoint-in-timeスナップショットであり、リアルタイムデータではありません。Amazon Glacier がボールトの最初のインベントリを作成した後、そのインベントリが取得可能になるまでに通常半日から最大 1 日かかることに注意してください。

アーカイブをアップロードするごとにボールトインベントリを取得することは、あまり便利には感じられないかもしれません。ただし、Amazon Glacier にアップロードするアーカイブに関するメタデータをクライアント側で関連付けてデータベースを維持するとします。そのような場合には、実際のボールトインベントリとデータベース内の情報とを必要に応じて照合できるため、ボールトインベントリの利便性が実感できるものと思われます。アーカイブの作成日でフィルタするか、クォータを設定することによって、取得されるインベントリの項目数を制限できます。インベントリの取得の制限の詳細については、「インベントリの取得の範囲」を参照してください。

インベントリは、カンマ区切り値 (CSV) と JSON の 2 つの形式で返すことができます。インベントリジョブを開始する際に、オプションで形式を指定できます。デフォルト形式は JSON です。インベントリジョブの出力で返されるデータフィールドの詳細については、Get Job Output APIの「レスポンス本文」を参照してください。