EventType

class aws_cdk.aws_s3.EventType(value)

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_lambda: lambda.Function

bucket = s3.Bucket.from_bucket_attributes(self, "ImportedBucket",
    bucket_arn="arn:aws:s3:::my-bucket"
)

# now you can just call methods on the bucket
bucket.add_event_notification(s3.EventType.OBJECT_CREATED, s3n.LambdaDestination(my_lambda),
    prefix="home/myusername/*"
)

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.