

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

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

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

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

# Amazon Glacier アーカイブの取得
<a name="downloading-an-archive-two-steps"></a>

Amazon Glacier からアーカイブから取り出すのは非同期オペレーションであり、最初にジョブを開始し、次にジョブが完了した後で出力をダウンロードします。アーカイブの取得ジョブを開始するには、、、または AWS SDKs [ジョブの開始 (ジョブの POST)](api-initiate-job-post.md) で REST API オペレーション AWS CLIまたは同等の を使用します。

**Topics**
+ [アーカイブの取り出しオプション](#api-downloading-an-archive-two-steps-retrieval-options)
+ [アーカイブの取得範囲](#downloading-an-archive-range)

Amazon Glacier からアーカイブを取り出すプロセスは、2 つのステップに分かれます。次はプロセスの概要です。

**アーカイブを取り出すには**

1. アーカイブの取得ジョブを開始します。

   1. 取得するアーカイブの ID を入手します。アーカイブ ID は、ボールトのインベントリから取得できます。アーカイブ ID は、REST API、 AWS CLI、または AWS SDKs を使用して取得できます。詳細については、「[Amazon Glacier でボールトインベントリをダウンロードする](vault-inventory.md)」を参照してください。

   1. [ジョブの開始 (ジョブの POST)](api-initiate-job-post.md) オペレーションを使用して、アーカイブの全体または一部を後にダウンロードするための準備を Amazon Glacier にリクエストするジョブを開始します。

   ジョブを開始すると、Amazon Glacier ではレスポンスでジョブ ID を返し、ジョブを非同期的に実行します (ステップ 2 で説明したように、ジョブが完了するまではジョブの出力をダウンロードできません)。
**重要**  
標準取り出しの場合のみ、データ取り出しポリシーにより、`PolicyEnforcedException` 例外が発生して、`Initiate Job` リクエストが失敗することがあります。データ取り出しポリシーの詳細については、「[Amazon Glacier のデータ取り出しポリシー](data-retrieval-policy.md)」を参照してください。`PolicyEnforcedException` 例外の詳細については、「[エラーレスポンス](api-error-responses.md)」を参照してください。

   必要に応じて、Amazon Glacier に保存されたデータの大きなセグメントを復元できます。Amazon Glacier ストレージクラスからデータを復元する方法の詳細については、「*Amazon Simple Storage Service ユーザーガイド*」の「[オブジェクトのアーカイブに適したストレージクラス]( https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html#sc-glacier)」を参照してください。

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

   全バイトをダウンロードすることも、バイト範囲を指定してジョブの出力の一部だけをダウンロードすることもできます。出力が大きい場合には、出力をチャンクに分けてダウンロードすると、ネットワーク障害など、ダウンロードに関する障害が発生したときに便利です。1 回のリクエストでジョブの出力を取得する場合に、ネットワーク障害が発生すると、最初から出力のダウンロードをやり直さなければならなくなります。これに対して、出力をチャンクに分けてダウンロードしていれば、障害が発生した場合でも、全体ではなく、出力の一部のダウンロードをやり直せば済みます。

Amazon Glacier では、出力を取得する前にジョブを完了している必要があります。ジョブは、完了から少なくとも 24 時間は有効です。つまり、ジョブが完了してから 24 時間は出力をダウンロードできます。復元の有効期限は、ジョブの完了から 24 時間 です。ジョブが完了しているかどうかを判断するには、以下のオプションの 1 つを使用してジョブのステータスを確認します。
+ **ジョブの完了通知を待つ** – ジョブの完了後に Amazon Glacier が通知を投稿する Amazon Simple Notification Service (Amazon SNS) トピックを指定できます。Amazon Glacier は、ジョブの完了後にのみ通知を送信します。

  ジョブを開始する際に、Amazon SNS トピックを指定できます。ジョブのリクエストで指定された Amazon SNS トピックのほか、ボールトにアーカイブの取り出しイベントに関する通知の設定がある場合には、Amazon Glacier からその SNS トピックにも通知が発行されます。詳細については、「[Amazon Glacier でボールト通知を設定する](configuring-notifications.md)」を参照してください。
+ **明示的にジョブ情報をリクエストする** - Amazon Glacier `Describe Job` API オペレーション ([ジョブの説明 (GET JobID)](api-describe-job-get.md)) を使用して、ジョブの情報を定期的にポーリングすることもできます。ただし、Amazon SNS 通知を使用することをお勧めします。

**注記**  
Amazon SNS 通知を使用して取得する情報は、`Describe Job` API オペレーションを呼び出して取得する情報と同じです。

## アーカイブの取り出しオプション
<a name="api-downloading-an-archive-two-steps-retrieval-options"></a>

アーカイブの取り出しジョブを開始するときは、アクセス時間とコスト要件に基づいて、以下のいずれかの取り出しオプションを指定できます。取り出し料金については、「[Amazon Glacier の料金](https://aws.amazon.com/s3/glacier/pricing/)」を参照してください。
+ **迅速** – 迅速取り出しを使用すると、アーカイブの復元に関する緊急のリクエストが臨時で必要になったときに、S3 Glacier Flexible Retrieval ストレージクラスまたは S3 Intelligent-Tiering Archive アクセス階層に保存されているデータにすばやくアクセスできます。最大規模のアーカイブ (250 MB 超) を除くすべてのアーカイブについては、迅速取り出しを使用してアクセスしたデータは通常 1〜5 分以内で使用可能になります。プロビジョンドキャパシティーは、迅速取り出しの取得容量を必要なときに利用できることを保証します。詳細については、「[プロビジョンドキャパシティー](#api-downloading-an-archive-two-steps-retrieval-expedited-capacity)」を参照してください。
+ **標準** - 標準取り出しでは、数時間以内にすべてのアーカイブにアクセスできます。通常、標準取り出しは 3〜5 時間で完了します。標準は、取り出しオプションを指定しないで取り出しリクエストを行った場合にデフォルトで適用されます。
+ **大容量** - 大容量取り出しは、Amazon Glacier の最も安価な取り出しオプションであり、これを使用して大量のデータ (ペタバイトのデータを含む) を 1 日以内に低コストで取得できます。通常、大容量取り出しは 5〜12 時間で完了します。

次の表は、アーカイブの取り出しオプションをまとめたものです。料金については、「[Amazon Glacier の料金](https://aws.amazon.com/s3/glacier/pricing/)」を参照してください。


| サービス | 迅速 | Standard | 大容量 | 
| --- | --- | --- | --- | 
| Amazon Glacier | 1～5 分 | 3～5 時間 | 5～12 時間 | 

`Expedited`、、`Standard`または `Bulk`の取得を行うには、REST API [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html) オペレーション`Tier`リクエストのリクエスト要素を必要なオプション、または AWS Command Line Interface (AWS CLI) または AWS SDKs の同等の に設定します。プロビジョンドキャパシティーを購入すると、すべての Expedited 取り出しはプロビジョンドキャパシティーを通じて自動的に提供されます。

### プロビジョンドキャパシティー
<a name="api-downloading-an-archive-two-steps-retrieval-expedited-capacity"></a>

プロビジョニングされたキャパシティーは、迅速取り出しの取得容量を必要なときに利用できることを保証します。容量の各単位について 5 分ごとに 3 回以上の迅速取り出しを提供し、1 秒あたり最大 150 メガバイト (MBps) の取り出しスループットを提供します。

ワークロードからデータのサブセットにアクセスする際に非常に高い信頼性と予測可能性が求められる場合は、プロビジョニングされた取得容量を購入することをお勧めします。プロビジョンドキャパシティーがなくても、需要が異常に高い例外的な場合を除いては、通常は迅速取り出しが受け入れられます。ただし、環境を問わず、どのような場合でも迅速取り出しにアクセスするには、プロビジョニングされた取得容量を購入してください。

#### プロビジョニングされた容量の購入
<a name="downloading-an-archive-purchase-provisioned-capacity"></a>

プロビジョニングされたキャパシティユニットは、Amazon Glacier コンソール、REST API [プロビジョニングされた容量の購入 (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md) オペレーション、 AWS SDKs、または を使用して購入できます AWS CLI。プロビジョニングされた容量の料金情報については、「[Amazon Glacier の料金](https://aws.amazon.com/s3/glacier/pricing/)」を参照してください。

プロビジョニングされた容量単位は、購入日時から 1 か月間有効です。

開始日が 31 日の場合、有効期限は翌月の最終日となります。たとえば、開始日が 8 月 31 日の場合、有効期限は 9 月 30 日です。開始日が 1 月 31 日の場合、有効期限は 2 月 28 日です。

**Amazon Glacier コンソールを使用してプロビジョニングされたキャパシティーを購入する方法**

1.  にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/glacier/home](https://console.aws.amazon.com/glacier/home) で Amazon Glacier コンソールを開きます。

1. 左側のナビゲーションペインで、**[データ取り出し設定]** を選択します。

1. **[プロビジョニングされたキャパシティユニット (PCU)]** で **[PCU の購入]** を選択します。**[PCU の購入]** ダイアログボックスが表示されます。

1. プロビジョニングされたキャパシティーを購入する場合は、**[購入を確認するには]** ボックスに **confirm** と入力します。

1.  **[PCU の購入]** を選択します。

## アーカイブの取得範囲
<a name="downloading-an-archive-range"></a>

Amazon Glacier からアーカイブを取得する場合は、取得するアーカイブの範囲 (部分) をオプションで指定することもできます。デフォルトでは、アーカイブ全体が取得されます。バイト範囲を指定すると、以下のことを行う場合に便利です。
+ **データのダウンロードの管理** - Amazon Glacier では、取り出しリクエストが完了してから 24 時間、取得したデータをダウンロードできます。このため、アーカイブの一部だけを取得することによって、特定のダウンロード期間内のダウンロードのスケジュールを管理できます。
+ **サイズの大きなアーカイブの特定の一部のみ取得** - たとえば、以前に多くのファイルをまとめ、1 つのアーカイブとしてアップロードしたものの、その後、ファイルの一部のみを取得する必要が生じたとします。このような場合には、取得リクエストを 1 回使用して、必要なファイルが含まれるアーカイブから一定の範囲を指定できます。このほか、取得リクエストを複数回、1 回ごとに 1 つまたは複数のファイルから成る範囲を指定して送信する方法もあります。

範囲取得を使用して取得ジョブを開始した場合には、メガバイト単位に調整した範囲を指定する必要があります。つまり、バイト範囲の始点はゼロ (アーカイブの先頭) またはその後 1 MB 間隔 (1 MB、2 MB、3 MB など) の点を指定することができます。

レンジの終わりの値には、アーカイブの末尾、またはレンジの開始値より大きな任意の 1 MB 間隔の数値のいずれかを指定できます。このほか、(取得ジョブが完了した後で) データをダウンロードする際にチェックサムの値を取得する場合には、ジョブの開始時にリクエストする範囲が木構造ハッシュ可能になっている必要があります。チェックサムを使用すると、データが送信中に破損しなかったかどうか確認できます。メガバイト単位への調整と木構造ハッシュを可能にするための調整については、「[データをダウンロードするときのチェックサムの受信](checksum-calculations-range.md)」を参照してください。