Class EventType
Notification event types.
Inheritance
Namespace: Amazon.CDK.AWS.S3
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public sealed class EventType : Enum
Syntax (vb)
Public NotInheritable Class EventType
Inherits
Enum
Remarks
ExampleMetadata: infused
Examples
Function myLambda;
var bucket = Bucket.FromBucketAttributes(this, "ImportedBucket", new BucketAttributes {
BucketArn = "arn:aws:s3:::my-bucket"
});
// now you can just call methods on the bucket
bucket.AddEventNotification(EventType.OBJECT_CREATED, new LambdaDestination(myLambda), new NotificationKeyFilter {
Prefix = "home/myusername/*"
});
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 |