Amazon S3 イベント通知 - Amazon Simple Storage Service

Amazon S3 イベント通知

Amazon S3 イベント通知機能を使用して、S3 バケットで特定のイベントが発生したときに通知を受け取ることができます。通知を有効にするには、Amazon S3 から発行するイベントを識別する通知設定を追加します。Amazon S3 から通知を送信する宛先も指定されていることを確認してください。この設定は、バケットに関連付けられた通知サブリソースに保存します 詳細については、バケット設定オプション を参照してください。Amazon S3 では、このサブリソースを管理するための API も利用できます。

重要

Amazon S3 イベント通知は、少なくとも 1 回配信されるように設計されています。通常、イベント通知は数秒で配信されますが、1 分以上かかる場合もあります。

Amazon S3 イベント通知の概要。

現在、Amazon S3 は次のイベントの通知を発行できます。

  • 新しいオブジェクトがイベントを作成しました。

  • オブジェクトの削除イベント

  • オブジェクトイベントの復元

  • 低冗長化ストレージ (RRS) オブジェクトがイベントを紛失した

  • レプリケーションイベント

  • S3 ライフサイクルの有効期限イベント

  • S3 ライフサイクルの移行イベント

  • S3 Intelligent−Tiering 自動アーカイブイベント

  • オブジェクトのタグ付けイベント

  • オブジェクト ACL PUT イベント

サポートしたすべてのイベントタイプの詳細は、SQS、SNS、および Lambda でサポートされているイベントタイプ を参照してください。

Amazon S3 は、次の宛先にイベントの通知メッセージを送信できます。通知設定でこれらの送信先の Amazon リソースネーム (ARN) 値を指定します。

  • Amazon Simple Notification Service (Amazon SNS) のトピック

  • Amazon Simple Queue Service (Amazon SQS) キュー

  • AWS Lambda 関数

  • Amazon EventBridge

詳細については、「サポートされているイベントの送信先」を参照してください。

注記

Amazon Simple キューサービス FIFO (先入れ先出し) キューは、Amazon S3 イベント通知の送信先としてサポートされていません。Amazon S3 イベントの通知を Amazon SQS FIFO キューに送信するには、Amazon EventBridge を使用できます。詳細については、「Amazon EventBridge を有効にします」を参照してください。

警告

通知が通知をトリガーするのと同じバケットに書き込むと、実行ループが発生する可能性があります。例えば、オブジェクトがアップロードされるたびにバケットで Lambda 関数をトリガーし、その関数によってオブジェクトがバケットにアップロードされると、その関数によって間接的にその関数自体がトリガーされます。これを回避するには、2 つのバケットを使用するか、受信オブジェクトで使用されるプレフィックスにのみ適用されるようにトリガーを設定します。

AWS Lambda で Amazon S3 通知を使用する方法の詳細と例については、AWS Lambda デベロッパーガイドAWS Lambda を Amazon S3 に使用するを参照してください。

バケットごとに作成できるイベント通知設定数の詳細については、AWS 全般のリファレンス「Amazon S3 サービスクォータ」を参照してください。

イベント通知の詳細については、以下のセクションを参照してください。