Enabling and configuring event notifications using the Amazon S3 console

You can enable certain Amazon S3 bucket events to send a notification message to a destination whenever those events occur. This section explains how to use the Amazon S3 console to enable event notifications. For information about how to use event notifications with the AWS SDKs and the Amazon S3 REST APIs, see Configuring event notifications programmatically.

Prerequisites: Before you can enable event notifications for your bucket, you must set up one of the destination types and then configure permissions. For more information, see Supported event destinations and Granting permissions to publish event notification messages to a destination.

Note

Amazon Simple Queue Service FIFO (First-In-First-Out) queues aren't supported as an Amazon S3 event notification destination. To send a notification for an Amazon S3 event to an Amazon SQS FIFO queue, you can use Amazon EventBridge. For more information, see Enabling Amazon EventBridge.

Enabling Amazon SNS, Amazon SQS, or Lambda notifications using the Amazon S3 console

To enable and configure event notifications for an S3 bucket

1. Sign in to the AWS Management Console and open the Amazon S3 console at https://console.aws.amazon.com/s3/.

2. In the Buckets list, choose the name of the bucket that you want to enable events for.

3. Choose Properties.

4. Navigate to the Event Notifications section and choose Create event notification.

5. In the General configuration section, specify descriptive event name for your event notification. Optionally, you can also specify a prefix and a suffix to limit the notifications to objects with keys ending in the specified characters.

   1. Enter a description for the Event name.

      If you don't enter a name, a globally unique identifier (GUID) is generated and used for the name.

   2. (Optional) To filter event notifications by prefix, enter a Prefix.

      For example, you can set up a prefix filter so that you receive notifications only when files are added to a specific folder (for example, images/).

   3. (Optional) To filter event notifications by suffix, enter a Suffix.

      For more information, see Configuring event notifications using object key name filtering.

6. In the Event types section, select one or more event types that you want to receive notifications for.

   For a list of the different event types, see Supported event types for SQS, SNS, and Lambda.

7. In the Destination section, choose the event notification destination.

   Note

   Before you can publish event notifications, you must grant the Amazon S3 principal the necessary permissions to call the relevant API. This is so that it can publish notifications to a Lambda function, SNS topic, or SQS queue.

   1. Select the destination type: Lambda Function, SNS Topic, or SQS Queue.

   2. After you choose your destination type, choose a function, topic, or queue from the list.

   3. Or, if you prefer to specify an Amazon Resource Name (ARN), select Enter ARN and enter the ARN.

   For more information, see Supported event destinations.

8. Choose Save changes, and Amazon S3 sends a test message to the event notification destination.