このページは、ボールトと 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 ストレージクラス
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Glacier でボールト通知を設定する
Amazon Glacier からのボールトのアーカイブやボールトインベントリなどの取得は 2 ステップのプロセスです。
-
取得ジョブを開始します。
-
ジョブが完了したら、ジョブの出力をダウンロードします。
ボールトの通知 設定で、ジョブが完了したときに Amazon Simple Notification Service (Amazon SNS) トピックにメッセージが送信されるように設定できます。
トピック
Amazon Glacier でのボールト通知の設定: 一般的な概念
Amazon Glacier の取り出しジョブリクエストは非同期的に実行されます。出力を取得するには、Amazon Glacier がジョブを完了するまで待機する必要があります。ジョブのステータスを確認するために定期的に Amazon Glacier にポーリングできますが、これは最適な方法ではありません。Amazon Glacier は通知もサポートしています。ジョブの完了時に、そのジョブで Amazon Simple Notification Service (Amazon SNS) トピックにメッセージを投稿できます。この機能を使用するには、ボールトの通知設定を指定する必要があります。設定では、イベントが発生したときに Amazon Glacier でメッセージを送信する 1 つ以上のイベントおよび Amazon SNS トピックを指定します。
Amazon Glacier では、ボールトの通知設定に追加できるジョブの完了に関連するイベント (ArchiveRetrievalCompleted、InventoryRetrievalCompleted) を定義しています。特定のジョブが完了すると、Amazon Glacier は SNS トピックに通知メッセージを発行します。
通知設定は以下の例に示すように JSON ドキュメントです。
{ "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] }
1 つのボールトに対して設定できる Amazon SNS トピックは 1 つのみです。
注記
ボールトに通知設定を追加すると、Amazon Glacier では、通知設定で指定されたイベントが発生するたびに通知を送信します。オプションで、各ジョブの開始リクエストで Amazon SNS トピックを指定することもできます。ボールトの通知設定を追加し、さらに、ジョブの開始リクエストで Amazon SNS トピックを指定した場合、Amazon Glacier は両方の通知を送信します。
Amazon Glacier が送信するジョブの完了メッセージには、ジョブのタイプ (InventoryRetrieval、ArchiveRetrieval)、ジョブの完了ステータス、SNS トピック名、ジョブのステータスコード、ボールト ARN などの情報が含まれます。次に、InventoryRetrieval ジョブの完了後に Amazon Glacier が SNS トピックに送信した通知の例を示します。
{ "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSizeInBytes": null, "Completed": true, "CompletionDate": "2012-06-12T22:20:40.790Z", "CreationDate": "2012-06-12T22:20:36.814Z", "InventorySizeInBytes":11693, "JobDescription": "my retrieval job", "JobId":"HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", "SHA256TreeHash":null, "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "StatusCode":"Succeeded", "StatusMessage": "Succeeded", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" }
Completed フィールドが true の場合は、StatusCode を確認して、ジョブが正常に完了したか、または失敗したかを確認する必要もあります。
注記
Amazon SNS トピックでは、ボールトで通知を発行できるようにする必要があります。デフォルトでは、Amazon SNS トピックの所有者のみがトピックにメッセージを発行できます。ただし、Amazon SNS トピックおよびボールトが異なる AWS アカウント によって所有されている場合は、ボールトからの通知を許可するように Amazon SNS トピックを設定する必要があります。Amazon SNS トピックのポリシーは、Amazon SNS コンソール で設定できます。
Amazon SNS の詳細については、「Amazon SNS の開始方法」を参照してください。