Amazon Simple Storage Service
コンソールユーザーガイド

S3 バケットのイベント通知を有効化および設定する方法

イベントが発生するたびに送信先へ通知メッセージを送信する、Amazon S3 バケットイベントを有効にすることができます。このセクションでは、Amazon S3 コンソールを使用してイベント通知を有効にする方法について説明します。AWS SDK と Amazon S3 REST API でイベント通知を使用する方法については、Amazon Simple Storage Service 開発者ガイド の「Amazon S3 イベントの通知の設定」を参照してください。

Amazon S3 イベント通知タイプおよび送信先

バケットのイベント通知を設定にする場合は、通知を受け取るイベントのタイプと通知の送信先を指定します。

Amazon S3 では、次のタイプのイベントに対して通知を送信できます。

  • オブジェクト作成イベント – コンソールでイベントを設定するときに [ObjectCreated (All)] を選択すると、オブジェクトがバケットで作成されるたびに通知が有効になります。または、1 つ以上の特定のオブジェクト作成アクションを選択することで、イベント通知がトリガーされるように設定できます。アクションには、[Put]、[Post]、[Copy]、および [CompleteMultiPartUpload] があります。

     

  • オブジェクト削除イベント – コンソールでイベントを設定するときに [ObjectDelete (All)] を選択すると、オブジェクトが削除されるたびに通知が有効になります。または、[削除] を選択することで、バージョニングされていないオブジェクトが削除されたとき、またはバージョニングされているオブジェクトが完全に削除されたときにイベント通知がトリガーされるように設定できます。[作成された削除マーカー] を選択すると、バージョニングされているオブジェクトに対して削除マーカーが作成されたときにイベント通知をトリガーできます。

     

  • オブジェクトイベントの復元イベント – コンソールでイベントを設定すると、GLACIER ストレージクラスに保存されているオブジェクトの復元についての通知を有効にできます。[Restore from Glacier initiated (Glacier からの復元を開始)] を選択すると、復元を開始したときに通知が送信されます。[Restore from Glacier completed (Glacier からの復元の完了)] を選択すると、オブジェクトの復元が完了したときに通知が送信されます。

     

  • 低冗長化ストレージ (RRS) オブジェクト消失イベント – [RRSObjectLost] を選択すると、RRS ストレージクラスのオブジェクトが消失したことを Amazon S3 が検出した際に通知が送信されます。

イベントの通知メッセージは、以下のタイプの送信先に送信できます。

  • Amazon Simple Notification Service (Amazon SNS) トピック – サブスクライブしているエンドポイントまたはクライアントへのメッセージの配信または送信を調整および管理するウェブサービスです。

     

  • Amazon Simple Queue Service (Amazon SQS) キュー – コンピュータ間で送受信されるメッセージを保存するための、信頼性の高いスケーラブルなホストされたキューが用意されています。

     

  • Lambda 関数 – AWS Lambda は、コードをアップロードできるコンピューティングサービスで、AWS インフラストラクチャを使用してユーザーの代わりにコードを実行します。Lambda 関数を作成するときに、カスタムコードをパッケージ化して AWS Lambda にアップロードできます。

     

イベント通知の有効化と設定

バケットのイベント通知を有効にするには、これらの送信先タイプのいずれか 1 つを設定する必要があります。詳細については、「イベント通知を受け取る送信先を設定する方法」を参照してください。

S3 バケットのイベント通知を有効化および設定するには

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

  2. [バケット名] のリストで、イベントを有効にするバケットの名前を選択します。

  3. [プロパティ] を選択します。

  4. [詳細設定] で、[イベント] を選択します。

  5. [通知の追加] を選択します。

  6. [名前] には、イベント設定のわかりやすい名前を入力します。名前を入力しなければ、GUID が自動的に生成され、名前として使用されます。

  7. [イベント] で、通知を受け取るイベント発生タイプを 1 つ以上選択します。イベントが発生すると、[ステップ 9] で選択した送信先に通知が送信されます。イベントタイプの説明については、「Amazon S3 イベント通知タイプおよび送信先」を参照してください。

    バージョニングされたオブジェクトの削除については、「オブジェクトバージョンの削除」を参照してください。オブジェクトのバージョニングについては、「オブジェクトのバージョニング」と「バージョニングの使用」を参照してください。

    注記

    フォルダーから最後のオブジェクトを作成すると、Amazon S3 がオブジェクト作成イベントを生成できます。次の条件が満たされると、Amazon S3 コンソールにフォルダが表示されます。1) 0 バイトオブジェクトの名前の末尾にスラッシュ (/) が含まれている (この場合、フォルダを表す 0 バイトの実際の Amazon S3 オブジェクトが存在します)、および 2) オブジェクトの名前にスラッシュ (/) が含まれている (この場合、フォルダを表す実際のオブジェクトは存在しません)。名前の一部に同じプレフィックスと末尾のスラッシュ (/) が含まれるオブジェクトが複数ある場合、それらのオブジェクトはフォルダーの一部として表示されます。フォルダー名は、末尾のスラッシュ (/) の前の文字で形成されます。そのフォルダーにリストされたすべてのオブジェクトを削除すると、空のフォルダを表すために使用可能な実際のオブジェクトはなくなります。このような場合、Amazon S3 コンソールによりフォルダーを表す 0 バイトのオブジェクトが作成されます。オブジェクト作成のイベント通知を有効にした場合、コンソールにより実行される 0 バイトオブジェクト作成アクションによりオブジェクト作成イベントがトリガーされます。

  8. オブジェクト名の [プレフィックス] または [サフィックス] (あるいはその両方) を入力し、イベント通知をプレフィックスまたはサフィックスでフィルタリングします。たとえば、ファイルがイメージフォルダーに追加されたときにのみ (たとえば、名前のプレフィックスが images/ であるオブジェクト) 通知が送信されるようにフィルターを設定できます。詳細については、「オブジェクトキー名によるフィルタリングを使用した通知の設定」を参照してください。

    
              イベントをフィルタリングするためのプレフィックスを入力する
  9. イベント通知を送信する送信先のタイプを選択します。送信先の説明については、「Amazon S3 イベント通知タイプおよび送信先」を参照してください。

    
              イベント
    1. [SNS トピック] 送信先タイプを選択すると、次のようになります。

      1. [SNS トピック] ボックスで、Amazon S3 から通知を受け取る Amazon SNS トピックの名前を入力するか、メニューから選択します。Amazon SNS トピックの形式については、「SNS のよくある質問」を参照してください。

        
                      イベント
      2. (オプション) メニューで [SNS トピックの ARN を追加] を選択し、[SNS トピックの ARN] に SNS トピックの ARN を入力することもできます。

        
                      イベント
    2. [SQS キュー] の送信先タイプを選択した場合、以下の作業を行います。

      1. [SQS キュー] で、Amazon S3 から通知を受け取る Amazon SQS キューの名前を入力するか、メニューから選択します。Amazon SQS の詳細については、Amazon Simple Queue Service 開発者ガイド の「Amazon Simple Queue Service とは」を参照してください。

      2. (オプション) メニューで [Add SQS topic ARN (SQS トピックの ARN を追加)] を選択し、[SQS キューの ARN] に SQS キューの ARN を入力することもできます。

    3. [Lambda 関数] の送信先タイプを選択した場合は、以下の作業を行います。

      1. [Lambda 関数] で、Amazon S3 から通知を受け取る Lambda 関数の名前を入力または選択します。

      2. バケットが含まれるリージョンに Lambda 関数がない場合、Lambda 関数の ARN を入力するよう求められます。[Lambda 関数の ARN] で、Amazon S3 から通知を受け取る Lambda 関数の ARN を入力します。

      3. (オプション) メニューで [Lambda 関数の ARN を追加] を選択し、[Lambda 関数の ARN] に Lambda 関数の ARN を入力することもできます。

      Lambda と Amazon S3 の使用の詳細については、AWS Lambda Developer Guide の「Amazon S3 で AWS Lambda: を使用する」を参照してください。

  10. [保存] を選択します。Amazon S3 はイベント通知の送信先にテストメッセージを送信します。

詳細

このページの内容: