このページは、Vaults と 2012 RESTAPI年のオリジナルを使用する S3 Glacier サービスの既存のお客様専用です。
アーカイブストレージソリューションをお探しの場合は、Amazon S3、S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive の S3 Glacier ストレージクラスを使用することをお勧めします。これらのストレージオプションの詳細については、Amazon S3 ユーザーガイドの「S3 Glacier ストレージクラス
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon S3 Glacier でのボールト通知の設定
Amazon S3 Glacier からのボールトのアーカイブやボールトインベントリなどの取得は 2 ステップのプロセスです。
-
取得ジョブを開始します。
-
ジョブが完了したら、ジョブの出力をダウンロードします。
ボールトの通知 設定で、ジョブが完了したときに Amazon Simple Notification Service (Amazon SNS) トピックにメッセージが送信されるように設定できます。
トピック
でのボールト通知の設定:S3 Glacier 一般的な概念
S3 Glacier の取り出しジョブリクエストは非同期的に実行されます。出力を取得するには、S3 Glacier がジョブを完了するまで待機する必要があります。ジョブのステータスを確認するために定期的に S3 Glacier にポーリングできますが、これは最適な方法ではありません。 では通知もサポートされています。S3 Glacier は通知もサポートしています。ジョブの完了時に、そのジョブで Amazon Simple Notification Service (Amazon SNS) トピックにメッセージを投稿できます。この機能を使用するには、ボールトの通知設定を指定する必要があります。設定では、イベントが発生したときに S3 Glacier でメッセージを送信する 1 つ以上のイベントおよび Amazon SNS トピックを指定します。
S3 Glacier では、ボールトの通知設定に追加できるジョブの完了に関連するイベント (ArchiveRetrievalCompleted
、InventoryRetrievalCompleted
) を定義しています。特定のジョブが完了すると、S3 Glacier は SNS トピックに通知メッセージを発行します。
通知設定は以下の例に示すように JSON ドキュメントです。
{ "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] }
1 つのボールトに対して設定できる Amazon SNS トピックは 1 つのみです。
注記
ボールトに通知設定を追加すると、S3 Glacier では、通知設定で指定されたイベントが発生するたびに通知を送信します。オプションで、各ジョブの開始リクエストで Amazon SNS トピックを指定することもできます。ボールトの通知設定を追加し、さらに、ジョブの開始リクエストで Amazon SNS トピックを指定した場合、S3 Glacier は両方の通知を送信します。
S3 Glacier が送信するジョブの完了メッセージには、ジョブのタイプ (InventoryRetrieval
、ArchiveRetrieval
)、ジョブの完了ステータス、SNS トピック名、ジョブのステータスコード、ボールト ARN などの情報が含まれます。次に、InventoryRetrieval
ジョブの完了後に S3 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 の使用開始」を参照してください。