Package software.amazon.awscdk.services.s3

Enum EventType

java.lang.Object
java.lang.Enum<EventType>
software.amazon.awscdk.services.s3.EventType
All Implemented Interfaces:
Serializable, Comparable<EventType>, java.lang.constant.Constable
@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)", date="2023-06-19T16:30:37.673Z") @Stability(Stable) public enum EventType extends Enum<EventType>
Notification event types.

Example: 

 Queue myQueue;
 Bucket bucket = new Bucket(this, "MyBucket");
 bucket.addEventNotification(EventType.OBJECT_REMOVED,
 new SqsDestination(myQueue), NotificationKeyFilter.builder().prefix("foo/").suffix(".jpg").build());

  • Nested Class Summary

    Nested classes/interfaces inherited from class java.lang.Enum

    Enum.EnumDesc<E extends Enum<E>>

  • Enum Constant Summary

    Enum Constants
    Enum Constant
    Description
    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.

  • Method Summary

    Modifier and Type
    Method
    Description
    static EventType
    valueOf(String name)
    Returns the enum constant of this type with the specified name.
    static EventType[]
    values()
    Returns an array containing the constants of this enum type, in the order they are declared.

    Methods inherited from class java.lang.Enum

    clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait

  • Enum Constant Details

    • OBJECT_CREATED

      @Stability(Stable) public static final EventType 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_PUT

      @Stability(Stable) public static final EventType 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_CREATED_POST

      @Stability(Stable) public static final EventType 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_COPY

      @Stability(Stable) public static final EventType 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_COMPLETE_MULTIPART_UPLOAD

      @Stability(Stable) public static final EventType 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_REMOVED

      @Stability(Stable) public static final EventType 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

      @Stability(Stable) public static final EventType 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

      @Stability(Stable) public static final EventType 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_POST

      @Stability(Stable) public static final EventType 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_RESTORE_COMPLETED

      @Stability(Stable) public static final EventType 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

      @Stability(Stable) public static final EventType 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.

    • REDUCED_REDUNDANCY_LOST_OBJECT

      @Stability(Stable) public static final 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.

    • REPLICATION_OPERATION_FAILED_REPLICATION

      @Stability(Stable) public static final 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.

    • REPLICATION_OPERATION_MISSED_THRESHOLD

      @Stability(Stable) public static final 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.

    • REPLICATION_OPERATION_REPLICATED_AFTER_THRESHOLD

      @Stability(Stable) public static final 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.

    • REPLICATION_OPERATION_NOT_TRACKED

      @Stability(Stable) public static final 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.

    • LIFECYCLE_EXPIRATION

      @Stability(Stable) public static final 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.

    • LIFECYCLE_EXPIRATION_DELETE

      @Stability(Stable) public static final EventType 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

      @Stability(Stable) public static final EventType 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

      @Stability(Stable) public static final EventType LIFECYCLE_TRANSITION
      You receive this notification event when an object is transitioned to another Amazon S3 storage class by an S3 Lifecycle configuration.

    • INTELLIGENT_TIERING

      @Stability(Stable) public static final EventType 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.

    • OBJECT_TAGGING

      @Stability(Stable) public static final EventType 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_PUT

      @Stability(Stable) public static final 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.

    • OBJECT_TAGGING_DELETE

      @Stability(Stable) public static final EventType OBJECT_TAGGING_DELETE
      The s3:ObjectTagging:Delete event type notifies you when a tag is removed from an object.

    • OBJECT_ACL_PUT

      @Stability(Stable) public static final EventType 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.

  • Method Details

    • values

      public static EventType[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      Returns:
      an array containing the constants of this enum type, in the order they are declared

    • valueOf

      public static EventType valueOf(String name)
      Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum type has no constant with the specified name
      NullPointerException - if the argument is null