Show / Hide Table of Contents

Class EventType

Notification event types.

Inheritance
System.Object
EventType
Namespace: Amazon.CDK.AWS.S3
Assembly: Amazon.CDK.AWS.S3.dll
Syntax (csharp)
public sealed class EventType : Enum
Syntax (vb)
Public NotInheritable Class EventType
    Inherits

     Enum
Remarks

ExampleMetadata: infused

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

Examples
Queue myQueue;

Bucket bucket = new Bucket(this, "MyBucket");
bucket.AddEventNotification(EventType.OBJECT_REMOVED,
new SqsDestination(myQueue), new NotificationKeyFilter { Prefix = "foo/", Suffix = ".jpg" });

Synopsis

Fields

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.

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.

OBJECT_CREATED

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

OBJECT_CREATED_COMPLETE_MULTIPART_UPLOAD

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

OBJECT_CREATED_COPY

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

OBJECT_CREATED_POST

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

OBJECT_CREATED_PUT

Amazon S3 APIs such as PUT, POST, and COPY can 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.

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.

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.

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.

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.

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.

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.

value__

Fields

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.

public const EventType INTELLIGENT_TIERING
Field Value
Type Description
EventType

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.

public const EventType LIFECYCLE_EXPIRATION
Field Value
Type Description
EventType

LIFECYCLE_EXPIRATION_DELETE

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

public const EventType LIFECYCLE_EXPIRATION_DELETE
Field Value
Type Description
EventType
Remarks

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.

public const EventType LIFECYCLE_EXPIRATION_DELETE_MARKER_CREATED
Field Value
Type Description
EventType

LIFECYCLE_TRANSITION

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

public const EventType LIFECYCLE_TRANSITION
Field Value
Type Description
EventType

OBJECT_ACL_PUT

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

public const EventType OBJECT_ACL_PUT
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_CREATED
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_CREATED_COMPLETE_MULTIPART_UPLOAD
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_CREATED_COPY
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_CREATED_POST
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_CREATED_PUT
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_REMOVED
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_REMOVED_DELETE
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_REMOVED_DELETE_MARKER_CREATED
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_RESTORE_COMPLETED
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_RESTORE_DELETE
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_RESTORE_POST
Field Value
Type Description
EventType
Remarks

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.

public const EventType OBJECT_TAGGING
Field Value
Type Description
EventType

OBJECT_TAGGING_DELETE

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

public const EventType OBJECT_TAGGING_DELETE
Field Value
Type Description
EventType

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.

public const EventType OBJECT_TAGGING_PUT
Field Value
Type Description
EventType

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.

public const EventType REDUCED_REDUNDANCY_LOST_OBJECT
Field Value
Type Description
EventType

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.

public const EventType REPLICATION_OPERATION_FAILED_REPLICATION
Field Value
Type Description
EventType

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.

public const EventType REPLICATION_OPERATION_MISSED_THRESHOLD
Field Value
Type Description
EventType

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.

public const EventType REPLICATION_OPERATION_NOT_TRACKED
Field Value
Type Description
EventType

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.

public const EventType REPLICATION_OPERATION_REPLICATED_AFTER_THRESHOLD
Field Value
Type Description
EventType

value__

public int value__
Field Value
Type Description
System.Int32
Back to top Generated by DocFX