EventType

class aws_cdk.aws_s3.EventType(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

Notification event types.

Link:

https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-event-types-and-destinations.html#supported-notification-event-types

ExampleMetadata:

infused

Example:

# my_queue: sqs.Queue

bucket = s3.Bucket(self, "MyBucket")
bucket.add_event_notification(s3.EventType.OBJECT_REMOVED, s3n.SqsDestination(my_queue),
    prefix="foo/",
    suffix=".jpg"
)

Attributes

INTELLIGENT_TIERING

You receive this notification event when an object within the S3 Intelligent-Tiering storage class moved to the Archive Access tier or Deep Archive Access tier.

LIFECYCLE_EXPIRATION

By using the LifecycleExpiration event types, you can receive a notification when Amazon S3 deletes an object based on your S3 Lifecycle configuration.

LIFECYCLE_EXPIRATION_DELETE

The s3:LifecycleExpiration:Delete event type notifies you when an object in an unversioned bucket is deleted.

It also notifies you when an object version is permanently deleted by an S3 Lifecycle configuration.

LIFECYCLE_EXPIRATION_DELETE_MARKER_CREATED

The s3:LifecycleExpiration:DeleteMarkerCreated event type notifies you when S3 Lifecycle creates a delete marker when a current version of an object in versioned bucket is deleted.

LIFECYCLE_TRANSITION

You receive this notification event when an object is transitioned to another Amazon S3 storage class by an S3 Lifecycle configuration.

OBJECT_ACL_PUT

You receive this notification event when an ACL is PUT on an object or when an existing ACL is changed.

An event is not generated when a request results in no change to an object’s ACL.

OBJECT_CREATED

Amazon S3 APIs such as PUT, POST, and COPY can create an object.

Using these event types, you can enable notification when an object is created using a specific API, or you can use the s3:ObjectCreated:* event type to request notification regardless of the API that was used to create an object.

OBJECT_CREATED_COMPLETE_MULTIPART_UPLOAD

Amazon S3 APIs such as PUT, POST, and COPY can create an object.

Using these event types, you can enable notification when an object is created using a specific API, or you can use the s3:ObjectCreated:* event type to request notification regardless of the API that was used to create an object.

OBJECT_CREATED_COPY

Amazon S3 APIs such as PUT, POST, and COPY can create an object.

Using these event types, you can enable notification when an object is created using a specific API, or you can use the s3:ObjectCreated:* event type to request notification regardless of the API that was used to create an object.

OBJECT_CREATED_POST

Amazon S3 APIs such as PUT, POST, and COPY can create an object.

Using these event types, you can enable notification when an object is created using a specific API, or you can use the s3:ObjectCreated:* event type to request notification regardless of the API that was used to create an object.

OBJECT_CREATED_PUT

Amazon S3 APIs such as PUT, POST, and COPY can create an object.

Using these event types, you can enable notification when an object is created using a specific API, or you can use the s3:ObjectCreated:* event type to request notification regardless of the API that was used to create an object.

OBJECT_REMOVED

By using the ObjectRemoved event types, you can enable notification when an object or a batch of objects is removed from a bucket.

You can request notification when an object is deleted or a versioned object is permanently deleted by using the s3:ObjectRemoved:Delete event type. Or you can request notification when a delete marker is created for a versioned object by using s3:ObjectRemoved:DeleteMarkerCreated. For information about deleting versioned objects, see Deleting Object Versions. You can also use a wildcard s3:ObjectRemoved:* to request notification anytime an object is deleted.

You will not receive event notifications from automatic deletes from lifecycle policies or from failed operations.

OBJECT_REMOVED_DELETE

By using the ObjectRemoved event types, you can enable notification when an object or a batch of objects is removed from a bucket.

You can request notification when an object is deleted or a versioned object is permanently deleted by using the s3:ObjectRemoved:Delete event type. Or you can request notification when a delete marker is created for a versioned object by using s3:ObjectRemoved:DeleteMarkerCreated. For information about deleting versioned objects, see Deleting Object Versions. You can also use a wildcard s3:ObjectRemoved:* to request notification anytime an object is deleted.

You will not receive event notifications from automatic deletes from lifecycle policies or from failed operations.

OBJECT_REMOVED_DELETE_MARKER_CREATED

By using the ObjectRemoved event types, you can enable notification when an object or a batch of objects is removed from a bucket.

You can request notification when an object is deleted or a versioned object is permanently deleted by using the s3:ObjectRemoved:Delete event type. Or you can request notification when a delete marker is created for a versioned object by using s3:ObjectRemoved:DeleteMarkerCreated. For information about deleting versioned objects, see Deleting Object Versions. You can also use a wildcard s3:ObjectRemoved:* to request notification anytime an object is deleted.

You will not receive event notifications from automatic deletes from lifecycle policies or from failed operations.

OBJECT_RESTORE_COMPLETED

Using restore object event types you can receive notifications for initiation and completion when restoring objects from the S3 Glacier storage class.

You use s3:ObjectRestore:Completed to request notification of restoration completion.

OBJECT_RESTORE_DELETE

Using restore object event types you can receive notifications for initiation and completion when restoring objects from the S3 Glacier storage class.

You use s3:ObjectRestore:Delete to request notification of restoration completion.

OBJECT_RESTORE_POST

Using restore object event types you can receive notifications for initiation and completion when restoring objects from the S3 Glacier storage class.

You use s3:ObjectRestore:Post to request notification of object restoration initiation.

OBJECT_TAGGING

By using the ObjectTagging event types, you can enable notification when an object tag is added or deleted from an object.

OBJECT_TAGGING_DELETE

The s3:ObjectTagging:Delete event type notifies you when a tag is removed from an object.

OBJECT_TAGGING_PUT

The s3:ObjectTagging:Put event type notifies you when a tag is PUT on an object or an existing tag is updated.

REDUCED_REDUNDANCY_LOST_OBJECT

You can use this event type to request Amazon S3 to send a notification message when Amazon S3 detects that an object of the RRS storage class is lost.

REPLICATION_OPERATION_FAILED_REPLICATION

You receive this notification event when an object that was eligible for replication using Amazon S3 Replication Time Control failed to replicate.

REPLICATION_OPERATION_MISSED_THRESHOLD

You receive this notification event when an object that was eligible for replication using Amazon S3 Replication Time Control exceeded the 15-minute threshold for replication.

REPLICATION_OPERATION_NOT_TRACKED

You receive this notification event for an object that was eligible for replication using Amazon S3 Replication Time Control but is no longer tracked by replication metrics.

REPLICATION_OPERATION_REPLICATED_AFTER_THRESHOLD

You receive this notification event for an object that was eligible for replication using the Amazon S3 Replication Time Control feature replicated after the 15-minute threshold.