Amazon S3 Glacier でのボールト通知の設定 - Amazon S3 Glacier

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

Amazon S3 Glacier でのボールト通知の設定

Amazon S3 Glacier (S3 Glacier) からの取得 (ボールトのアーカイブやボールトインベントリの取得など) は 2 ステップのプロセスです。

  1. 取得ジョブを開始します。

  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 ドキュメントです。

{ "Topic": "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。次に、S3 Glacier が SNS トピックに送信した通知の例を示します。InventoryRetrievalジョブが完了しました。

{ "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 トピックでは、ボールトで通知を発行できるようにする必要があることに注意してください。デフォルトでは、SNS トピックの所有者のみがトピックにメッセージを発行できます。ただし、SNS トピックおよびボールトが異なる AWS アカウント で、ボールトからの通知を許可するように SNS トピックを設定する必要があります。Amazon SNS コンソールで SNS トピックポリシーを設定できます。

Amazon SNS の詳細については、「」を参照してください。Amazon SNS の使用開始