Amazon S3 Glacier でボールトインベントリをダウンロードする

最初のアーカイブをボールトにアップロードすると、Amazon S3 Glacier (S3 Glacier) により、ボールトインベントリが自動的に作成され、インベントリが約 1 日 1 回のペースで更新されます。S3 Glacier によって最初に作成されるインベントリは、取得できるようになるまで、通常半日から最大 1 日かかります。次の 2 ステップのプロセスで、S3 Glacier からボールトインベントリを取得できます。

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

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

インベントリについて

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

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

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