Using EventBridge - Amazon Simple Storage Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Using EventBridge

Amazon S3 can send events to Amazon EventBridge whenever certain events happen in your bucket. Unlike other destinations, you don't need to select which event types you want to deliver. After EventBridge is enabled, all events below are sent to EventBridge. You can use EventBridge rules to route events to additional targets. The following lists the events Amazon S3 sends to EventBridge.

Event type Description

Object Created

An object was created.

The reason field in the event message structure indicates which S3 API was used to create the object: PutObject, POST Object, CopyObject, or CompleteMultipartUpload.

Object Deleted (DeleteObject)

Object Deleted (Lifecycle expiration)

An object was deleted.

When an object is deleted using an S3 API call, the reason field is set to DeleteObject. When an object is deleted by an S3 Lifecycle expiration rule, the reason field is set to Lifecycle Expiration. For more information, see Expiring objects.

When an unversioned object is deleted, or a versioned object is permanently deleted, the deletion-type field is set to Permanently Deleted. When a delete marker is created for a versioned object, the deletion-type field is set to Delete Marker Created. For more information, see Deleting object versions from a versioning-enabled bucket.

Object Restore Initiated

An object restore was initiated from S3 Glacier or S3 Glacier Deep Archive storage class or from S3 Intelligent-Tiering Archive Access or Deep Archive Access tier. For more information, see Working with archived objects.

Object Restore Completed

An object restore was completed.

Object Restore Expired

The temporary copy of an object restored from S3 Glacier or S3 Glacier Deep Archive expired and was deleted.

Object Storage Class Changed

An object was transitioned to a different storage class. For more information, see Transitioning objects using Amazon S3 Lifecycle.

Object Access Tier Changed

An object was transitioned to the S3 Intelligent-Tiering Archive Access tier or Deep Archive Access tier. For more information, see Amazon S3 Intelligent-Tiering.

Object ACL Updated

An object's access control list (ACL) was set using PutObjectACL. An event is not generated when a request results in no change to an object’s ACL. For more information, see Access control list (ACL) overview.

Object Tags Added

A set of tags was added to an object using PutObjectTagging. For more information, see Categorizing your storage using tags.

Object Tags Deleted

All tags were removed from an object using DeleteObjectTagging. For more information, see Categorizing your storage using tags.

Note

For more information about how Amazon S3 event types map to EventBridge event types, see Amazon EventBridge mapping and troubleshooting.

You can use Amazon S3 Event Notifications with EventBridge to write rules that take actions when an event occurs in your bucket. For example, you can have it send you a notification. For more information, see What is EventBridge in the Amazon EventBridge User Guide.

For information about pricing, see Amazon EventBridge pricing.