aws-cdk-lib 2.73.0__py3-none-any.whl → 2.76.0__py3-none-any.whl

aws_cdk/aws_ses/__init__.py

@@ -136,6 +136,18 @@ ses.ConfigurationSet(self, "ConfigurationSet",
 )
 ```
 
+Use `addEventDestination()` to publish email sending events to Amazon SNS or Amazon CloudWatch:
+
+```python
+# my_configuration_set: ses.ConfigurationSet
+# my_topic: sns.Topic
+
+
+my_configuration_set.add_event_destination("ToSns",
+    destination=ses.EventDestination.sns_topic(my_topic)
+)
+```
+
 ### Email identity
 
 In Amazon SES, a verified identity is a domain or email address that you use to send or receive email. Before you
@@ -146,11 +158,10 @@ helps prevent unauthorized use.
 To verify an identity for a hosted zone, you create an `EmailIdentity`:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # my_hosted_zone: route53.IPublicHostedZone
 
 
-identity = ses.EmailIdentity(stack, "Identity",
+identity = ses.EmailIdentity(self, "Identity",
     identity=ses.Identity.public_hosted_zone(my_hosted_zone),
     mail_from_domain="mail.cdk.dev"
 )
@@ -163,13 +174,12 @@ You can instead configure DKIM authentication by using your own public-private k
 as [Bring Your Own DKIM (BYODKIM)](https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-bring-your-own.html):
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # my_hosted_zone: route53.IPublicHostedZone
 
 
-ses.EmailIdentity(stack, "Identity",
+ses.EmailIdentity(self, "Identity",
     identity=ses.Identity.public_hosted_zone(my_hosted_zone),
-    dkim_identity=DkimIdentity.byo_dkim(
+    dkim_identity=ses.DkimIdentity.byo_dkim(
         private_key=SecretValue.secrets_manager("dkim-private-key"),
         public_key="...base64-encoded-public-key...",
         selector="selector"
@@ -186,8 +196,7 @@ When using `publicHostedZone()` for the identity, all necessary Amazon Route 53
 When working with `domain()`, records must be created manually:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
-identity = ses.EmailIdentity(stack, "Identity",
+identity = ses.EmailIdentity(self, "Identity",
     identity=ses.Identity.domain("cdk.dev")
 )
 
@@ -236,6 +245,7 @@ from .. import (
     TreeInspector as _TreeInspector_488e0dd5,
 )
 from ..aws_route53 import IPublicHostedZone as _IPublicHostedZone_9b6e7da4
+from ..aws_sns import ITopic as _ITopic_9eca4852
 
 
 @jsii.data_type(
@@ -546,23 +556,20 @@ class ByoDkimOptions:
         :param selector: A string that's used to identify a public key in the DNS configuration for a domain.
         :param public_key: The public key. If specified, a TXT record with the public key is created. Default: - the validation TXT record with the public key is not created
 
-        :exampleMetadata: fixture=_generated
+        :exampleMetadata: infused
 
         Example::
 
-            # The code below shows an example of how to instantiate this type.
-            # The values are placeholders you should change.
-            import aws_cdk as cdk
-            from aws_cdk import aws_ses as ses
-            
-            # secret_value: cdk.SecretValue
+            # my_hosted_zone: route53.IPublicHostedZone
             
-            byo_dkim_options = ses.ByoDkimOptions(
-                private_key=secret_value,
-                selector="selector",
             
-                # the properties below are optional
-                public_key="publicKey"
+            ses.EmailIdentity(self, "Identity",
+                identity=ses.Identity.public_hosted_zone(my_hosted_zone),
+                dkim_identity=ses.DkimIdentity.byo_dkim(
+                    private_key=SecretValue.secrets_manager("dkim-private-key"),
+                    public_key="...base64-encoded-public-key...",
+                    selector="selector"
+                )
             )
         '''
         if __debug__:
@@ -6333,6 +6340,331 @@ class CfnVdmAttributesProps:
         )
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_ses.CloudWatchDimension",
+    jsii_struct_bases=[],
+    name_mapping={"default_value": "defaultValue", "name": "name", "source": "source"},
+)
+class CloudWatchDimension:
+    def __init__(
+        self,
+        *,
+        default_value: builtins.str,
+        name: builtins.str,
+        source: "CloudWatchDimensionSource",
+    ) -> None:
+        '''A CloudWatch dimension upon which to categorize your emails.
+
+        :param default_value: The default value of the dimension that is published to Amazon CloudWatch if you do not provide the value of the dimension when you send an email.
+        :param name: The name of an Amazon CloudWatch dimension associated with an email sending metric.
+        :param source: The place where Amazon SES finds the value of a dimension to publish to Amazon CloudWatch.
+
+        :exampleMetadata: fixture=_generated
+
+        Example::
+
+            # The code below shows an example of how to instantiate this type.
+            # The values are placeholders you should change.
+            from aws_cdk import aws_ses as ses
+            
+            cloud_watch_dimension = ses.CloudWatchDimension(
+                default_value="defaultValue",
+                name="name",
+                source=ses.CloudWatchDimensionSource.EMAIL_HEADER
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__c718e80d3dd746209ff12fd14d08ce529bed18f85e0af362c1a2df8b5adc173a)
+            check_type(argname="argument default_value", value=default_value, expected_type=type_hints["default_value"])
+            check_type(argname="argument name", value=name, expected_type=type_hints["name"])
+            check_type(argname="argument source", value=source, expected_type=type_hints["source"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "default_value": default_value,
+            "name": name,
+            "source": source,
+        }
+
+    @builtins.property
+    def default_value(self) -> builtins.str:
+        '''The default value of the dimension that is published to Amazon CloudWatch if you do not provide the value of the dimension when you send an email.'''
+        result = self._values.get("default_value")
+        assert result is not None, "Required property 'default_value' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def name(self) -> builtins.str:
+        '''The name of an Amazon CloudWatch dimension associated with an email sending metric.'''
+        result = self._values.get("name")
+        assert result is not None, "Required property 'name' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def source(self) -> "CloudWatchDimensionSource":
+        '''The place where Amazon SES finds the value of a dimension to publish to Amazon CloudWatch.'''
+        result = self._values.get("source")
+        assert result is not None, "Required property 'source' is missing"
+        return typing.cast("CloudWatchDimensionSource", result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "CloudWatchDimension(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.enum(jsii_type="aws-cdk-lib.aws_ses.CloudWatchDimensionSource")
+class CloudWatchDimensionSource(enum.Enum):
+    '''Source for CloudWatch dimension.'''
+
+    EMAIL_HEADER = "EMAIL_HEADER"
+    '''Amazon SES retrieves the dimension name and value from a header in the email.
+
+    Note: You can't use any of the following email headers as the Dimension Name:
+    ``Received``, ``To``, ``From``, ``DKIM-Signature``, ``CC``, ``message-id``, or ``Return-Path``.
+    '''
+    LINK_TAG = "LINK_TAG"
+    '''Amazon SES retrieves the dimension name and value from a tag that you specified in a link.
+
+    :see: https://docs.aws.amazon.com/ses/latest/dg/faqs-metrics.html#sending-metric-faqs-clicks-q5
+    '''
+    MESSAGE_TAG = "MESSAGE_TAG"
+    '''Amazon SES retrieves the dimension name and value from a tag that you specify by using the ``X-SES-MESSAGE-TAGS`` header or the Tags API parameter.
+
+    You can also use the Message Tag value source to create dimensions based on Amazon SES auto-tags.
+    To use an auto-tag, type the complete name of the auto-tag as the Dimension Name. For example,
+    to create a dimension based on the configuration set auto-tag, use ``ses:configuration-set`` for the
+    Dimension Name, and the name of the configuration set for the Default Value.
+
+    :see: https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html#event-publishing-how-works
+    '''
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_ses.ConfigurationSetEventDestinationOptions",
+    jsii_struct_bases=[],
+    name_mapping={
+        "destination": "destination",
+        "configuration_set_event_destination_name": "configurationSetEventDestinationName",
+        "enabled": "enabled",
+        "events": "events",
+    },
+)
+class ConfigurationSetEventDestinationOptions:
+    def __init__(
+        self,
+        *,
+        destination: "EventDestination",
+        configuration_set_event_destination_name: typing.Optional[builtins.str] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        events: typing.Optional[typing.Sequence["EmailSendingEvent"]] = None,
+    ) -> None:
+        '''Options for a configuration set event destination.
+
+        :param destination: The event destination.
+        :param configuration_set_event_destination_name: A name for the configuration set event destination. Default: - a CloudFormation generated name
+        :param enabled: Whether Amazon SES publishes events to this destination. Default: true
+        :param events: The type of email sending events to publish to the event destination. Default: - send all event types
+
+        :exampleMetadata: infused
+
+        Example::
+
+            # my_configuration_set: ses.ConfigurationSet
+            # my_topic: sns.Topic
+            
+            
+            my_configuration_set.add_event_destination("ToSns",
+                destination=ses.EventDestination.sns_topic(my_topic)
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__80b5162c2d2ea9081e7450a4b5db43212eaf82f433a217fb2be6e012977034b6)
+            check_type(argname="argument destination", value=destination, expected_type=type_hints["destination"])
+            check_type(argname="argument configuration_set_event_destination_name", value=configuration_set_event_destination_name, expected_type=type_hints["configuration_set_event_destination_name"])
+            check_type(argname="argument enabled", value=enabled, expected_type=type_hints["enabled"])
+            check_type(argname="argument events", value=events, expected_type=type_hints["events"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "destination": destination,
+        }
+        if configuration_set_event_destination_name is not None:
+            self._values["configuration_set_event_destination_name"] = configuration_set_event_destination_name
+        if enabled is not None:
+            self._values["enabled"] = enabled
+        if events is not None:
+            self._values["events"] = events
+
+    @builtins.property
+    def destination(self) -> "EventDestination":
+        '''The event destination.'''
+        result = self._values.get("destination")
+        assert result is not None, "Required property 'destination' is missing"
+        return typing.cast("EventDestination", result)
+
+    @builtins.property
+    def configuration_set_event_destination_name(self) -> typing.Optional[builtins.str]:
+        '''A name for the configuration set event destination.
+
+        :default: - a CloudFormation generated name
+        '''
+        result = self._values.get("configuration_set_event_destination_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def enabled(self) -> typing.Optional[builtins.bool]:
+        '''Whether Amazon SES publishes events to this destination.
+
+        :default: true
+        '''
+        result = self._values.get("enabled")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
+    @builtins.property
+    def events(self) -> typing.Optional[typing.List["EmailSendingEvent"]]:
+        '''The type of email sending events to publish to the event destination.
+
+        :default: - send all event types
+        '''
+        result = self._values.get("events")
+        return typing.cast(typing.Optional[typing.List["EmailSendingEvent"]], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "ConfigurationSetEventDestinationOptions(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_ses.ConfigurationSetEventDestinationProps",
+    jsii_struct_bases=[ConfigurationSetEventDestinationOptions],
+    name_mapping={
+        "destination": "destination",
+        "configuration_set_event_destination_name": "configurationSetEventDestinationName",
+        "enabled": "enabled",
+        "events": "events",
+        "configuration_set": "configurationSet",
+    },
+)
+class ConfigurationSetEventDestinationProps(ConfigurationSetEventDestinationOptions):
+    def __init__(
+        self,
+        *,
+        destination: "EventDestination",
+        configuration_set_event_destination_name: typing.Optional[builtins.str] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        events: typing.Optional[typing.Sequence["EmailSendingEvent"]] = None,
+        configuration_set: "IConfigurationSet",
+    ) -> None:
+        '''Properties for a configuration set event destination.
+
+        :param destination: The event destination.
+        :param configuration_set_event_destination_name: A name for the configuration set event destination. Default: - a CloudFormation generated name
+        :param enabled: Whether Amazon SES publishes events to this destination. Default: true
+        :param events: The type of email sending events to publish to the event destination. Default: - send all event types
+        :param configuration_set: The configuration set that contains the event destination.
+
+        :exampleMetadata: fixture=_generated
+
+        Example::
+
+            # The code below shows an example of how to instantiate this type.
+            # The values are placeholders you should change.
+            from aws_cdk import aws_ses as ses
+            
+            # configuration_set: ses.ConfigurationSet
+            # event_destination: ses.EventDestination
+            
+            configuration_set_event_destination_props = ses.ConfigurationSetEventDestinationProps(
+                configuration_set=configuration_set,
+                destination=event_destination,
+            
+                # the properties below are optional
+                configuration_set_event_destination_name="configurationSetEventDestinationName",
+                enabled=False,
+                events=[ses.EmailSendingEvent.SEND]
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__dd3ac4f1af1f2fe9c11fa8894b2eae0f4b13c464b826cffda8b6937f4ab3e9c8)
+            check_type(argname="argument destination", value=destination, expected_type=type_hints["destination"])
+            check_type(argname="argument configuration_set_event_destination_name", value=configuration_set_event_destination_name, expected_type=type_hints["configuration_set_event_destination_name"])
+            check_type(argname="argument enabled", value=enabled, expected_type=type_hints["enabled"])
+            check_type(argname="argument events", value=events, expected_type=type_hints["events"])
+            check_type(argname="argument configuration_set", value=configuration_set, expected_type=type_hints["configuration_set"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "destination": destination,
+            "configuration_set": configuration_set,
+        }
+        if configuration_set_event_destination_name is not None:
+            self._values["configuration_set_event_destination_name"] = configuration_set_event_destination_name
+        if enabled is not None:
+            self._values["enabled"] = enabled
+        if events is not None:
+            self._values["events"] = events
+
+    @builtins.property
+    def destination(self) -> "EventDestination":
+        '''The event destination.'''
+        result = self._values.get("destination")
+        assert result is not None, "Required property 'destination' is missing"
+        return typing.cast("EventDestination", result)
+
+    @builtins.property
+    def configuration_set_event_destination_name(self) -> typing.Optional[builtins.str]:
+        '''A name for the configuration set event destination.
+
+        :default: - a CloudFormation generated name
+        '''
+        result = self._values.get("configuration_set_event_destination_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def enabled(self) -> typing.Optional[builtins.bool]:
+        '''Whether Amazon SES publishes events to this destination.
+
+        :default: true
+        '''
+        result = self._values.get("enabled")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
+    @builtins.property
+    def events(self) -> typing.Optional[typing.List["EmailSendingEvent"]]:
+        '''The type of email sending events to publish to the event destination.
+
+        :default: - send all event types
+        '''
+        result = self._values.get("events")
+        return typing.cast(typing.Optional[typing.List["EmailSendingEvent"]], result)
+
+    @builtins.property
+    def configuration_set(self) -> "IConfigurationSet":
+        '''The configuration set that contains the event destination.'''
+        result = self._values.get("configuration_set")
+        assert result is not None, "Required property 'configuration_set' is missing"
+        return typing.cast("IConfigurationSet", result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "ConfigurationSetEventDestinationProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_ses.ConfigurationSetProps",
     jsii_struct_bases=[],
@@ -6572,13 +6904,12 @@ class DkimIdentity(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # my_hosted_zone: route53.IPublicHostedZone
         
         
-        ses.EmailIdentity(stack, "Identity",
+        ses.EmailIdentity(self, "Identity",
             identity=ses.Identity.public_hosted_zone(my_hosted_zone),
-            dkim_identity=DkimIdentity.byo_dkim(
+            dkim_identity=ses.DkimIdentity.byo_dkim(
                 private_key=SecretValue.secrets_manager("dkim-private-key"),
                 public_key="...base64-encoded-public-key...",
                 selector="selector"
@@ -6950,11 +7281,10 @@ class EmailIdentityProps:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # my_hosted_zone: route53.IPublicHostedZone
             
             
-            identity = ses.EmailIdentity(stack, "Identity",
+            identity = ses.EmailIdentity(self, "Identity",
                 identity=ses.Identity.public_hosted_zone(my_hosted_zone),
                 mail_from_domain="mail.cdk.dev"
             )
@@ -7075,6 +7405,143 @@ class EmailIdentityProps:
         )
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_ses.EmailSendingEvent")
+class EmailSendingEvent(enum.Enum):
+    '''Email sending event.'''
+
+    SEND = "SEND"
+    '''The send request was successful and SES will attempt to deliver the message to the recipient's mail server.
+
+    (If account-level or global suppression is
+    being used, SES will still count it as a send, but delivery is suppressed.)
+    '''
+    REJECT = "REJECT"
+    '''SES accepted the email, but determined that it contained a virus and didn’t attempt to deliver it to the recipient’s mail server.'''
+    BOUNCE = "BOUNCE"
+    '''(Hard bounce) The recipient's mail server permanently rejected the email.
+
+    (Soft bounces are only included when SES fails to deliver the email after
+    retrying for a period of time.)
+    '''
+    COMPLAINT = "COMPLAINT"
+    '''The email was successfully delivered to the recipient’s mail server, but the recipient marked it as spam.'''
+    DELIVERY = "DELIVERY"
+    '''SES successfully delivered the email to the recipient's mail server.'''
+    OPEN = "OPEN"
+    '''The recipient received the message and opened it in their email client.'''
+    CLICK = "CLICK"
+    '''The recipient clicked one or more links in the email.'''
+    RENDERING_FAILURE = "RENDERING_FAILURE"
+    '''The email wasn't sent because of a template rendering issue.
+
+    This event type
+    can occur when template data is missing, or when there is a mismatch between
+    template parameters and data. (This event type only occurs when you send email
+    using the ``SendTemplatedEmail`` or ``SendBulkTemplatedEmail`` API operations.)
+    '''
+    DELIVERY_DELAY = "DELIVERY_DELAY"
+    '''The email couldn't be delivered to the recipient’s mail server because a temporary issue occurred.
+
+    Delivery delays can occur, for example, when the recipient's inbox
+    is full, or when the receiving email server experiences a transient issue.
+    '''
+    SUBSCRIPTION = "SUBSCRIPTION"
+    '''The email was successfully delivered, but the recipient updated their subscription preferences by clicking on an unsubscribe link as part of your subscription management.'''
+
+
+class EventDestination(
+    metaclass=jsii.JSIIAbstractClass,
+    jsii_type="aws-cdk-lib.aws_ses.EventDestination",
+):
+    '''An event destination.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        # my_configuration_set: ses.ConfigurationSet
+        # my_topic: sns.Topic
+        
+        
+        my_configuration_set.add_event_destination("ToSns",
+            destination=ses.EventDestination.sns_topic(my_topic)
+        )
+    '''
+
+    def __init__(self) -> None:
+        jsii.create(self.__class__, self, [])
+
+    @jsii.member(jsii_name="cloudWatchDimensions")
+    @builtins.classmethod
+    def cloud_watch_dimensions(
+        cls,
+        dimensions: typing.Sequence[typing.Union[CloudWatchDimension, typing.Dict[builtins.str, typing.Any]]],
+    ) -> "EventDestination":
+        '''Use CloudWatch dimensions as event destination.
+
+        :param dimensions: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__48f9cce8b82649ed9874f37f0ed571721b324063ca98764a07bb10a451e9fe92)
+            check_type(argname="argument dimensions", value=dimensions, expected_type=type_hints["dimensions"])
+        return typing.cast("EventDestination", jsii.sinvoke(cls, "cloudWatchDimensions", [dimensions]))
+
+    @jsii.member(jsii_name="snsTopic")
+    @builtins.classmethod
+    def sns_topic(cls, topic: _ITopic_9eca4852) -> "EventDestination":
+        '''Use a SNS topic as event destination.
+
+        :param topic: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__70dbe9528b7fbaa2cbed5b1def55a8c3126fbfed3ee256b878bbb907e4585c9c)
+            check_type(argname="argument topic", value=topic, expected_type=type_hints["topic"])
+        return typing.cast("EventDestination", jsii.sinvoke(cls, "snsTopic", [topic]))
+
+    @builtins.property
+    @jsii.member(jsii_name="dimensions")
+    @abc.abstractmethod
+    def dimensions(self) -> typing.Optional[typing.List[CloudWatchDimension]]:
+        '''A list of CloudWatch dimensions upon which to categorize your emails.
+
+        :default: - do not send events to CloudWatch
+        '''
+        ...
+
+    @builtins.property
+    @jsii.member(jsii_name="topic")
+    @abc.abstractmethod
+    def topic(self) -> typing.Optional[_ITopic_9eca4852]:
+        '''A SNS topic to use as event destination.
+
+        :default: - do not send events to a SNS topic
+        '''
+        ...
+
+
+class _EventDestinationProxy(EventDestination):
+    @builtins.property
+    @jsii.member(jsii_name="dimensions")
+    def dimensions(self) -> typing.Optional[typing.List[CloudWatchDimension]]:
+        '''A list of CloudWatch dimensions upon which to categorize your emails.
+
+        :default: - do not send events to CloudWatch
+        '''
+        return typing.cast(typing.Optional[typing.List[CloudWatchDimension]], jsii.get(self, "dimensions"))
+
+    @builtins.property
+    @jsii.member(jsii_name="topic")
+    def topic(self) -> typing.Optional[_ITopic_9eca4852]:
+        '''A SNS topic to use as event destination.
+
+        :default: - do not send events to a SNS topic
+        '''
+        return typing.cast(typing.Optional[_ITopic_9eca4852], jsii.get(self, "topic"))
+
+# Adding a "__jsii_proxy_class__(): typing.Type" function to the abstract class
+typing.cast(typing.Any, EventDestination).__jsii_proxy_class__ = lambda : _EventDestinationProxy
+
+
 @jsii.interface(jsii_type="aws-cdk-lib.aws_ses.IConfigurationSet")
 class IConfigurationSet(_IResource_c80c4260, typing_extensions.Protocol):
     '''A configuration set.'''
@@ -7109,6 +7576,43 @@ class _IConfigurationSetProxy(
 typing.cast(typing.Any, IConfigurationSet).__jsii_proxy_class__ = lambda : _IConfigurationSetProxy
 
 
+@jsii.interface(jsii_type="aws-cdk-lib.aws_ses.IConfigurationSetEventDestination")
+class IConfigurationSetEventDestination(
+    _IResource_c80c4260,
+    typing_extensions.Protocol,
+):
+    '''A configuration set event destination.'''
+
+    @builtins.property
+    @jsii.member(jsii_name="configurationSetEventDestinationId")
+    def configuration_set_event_destination_id(self) -> builtins.str:
+        '''The ID of the configuration set event destination.
+
+        :attribute: true
+        '''
+        ...
+
+
+class _IConfigurationSetEventDestinationProxy(
+    jsii.proxy_for(_IResource_c80c4260), # type: ignore[misc]
+):
+    '''A configuration set event destination.'''
+
+    __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_ses.IConfigurationSetEventDestination"
+
+    @builtins.property
+    @jsii.member(jsii_name="configurationSetEventDestinationId")
+    def configuration_set_event_destination_id(self) -> builtins.str:
+        '''The ID of the configuration set event destination.
+
+        :attribute: true
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "configurationSetEventDestinationId"))
+
+# Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
+typing.cast(typing.Any, IConfigurationSetEventDestination).__jsii_proxy_class__ = lambda : _IConfigurationSetEventDestinationProxy
+
+
 @jsii.interface(jsii_type="aws-cdk-lib.aws_ses.IDedicatedIpPool")
 class IDedicatedIpPool(_IResource_c80c4260, typing_extensions.Protocol):
     '''A dedicated IP pool.'''
@@ -7393,11 +7897,10 @@ class Identity(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # my_hosted_zone: route53.IPublicHostedZone
         
         
-        identity = ses.EmailIdentity(stack, "Identity",
+        identity = ses.EmailIdentity(self, "Identity",
             identity=ses.Identity.public_hosted_zone(my_hosted_zone),
             mail_from_domain="mail.cdk.dev"
         )
@@ -9183,6 +9686,36 @@ class ConfigurationSet(
             check_type(argname="argument configuration_set_name", value=configuration_set_name, expected_type=type_hints["configuration_set_name"])
         return typing.cast(IConfigurationSet, jsii.sinvoke(cls, "fromConfigurationSetName", [scope, id, configuration_set_name]))
 
+    @jsii.member(jsii_name="addEventDestination")
+    def add_event_destination(
+        self,
+        id: builtins.str,
+        *,
+        destination: EventDestination,
+        configuration_set_event_destination_name: typing.Optional[builtins.str] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        events: typing.Optional[typing.Sequence[EmailSendingEvent]] = None,
+    ) -> "ConfigurationSetEventDestination":
+        '''Adds an event destination to this configuration set.
+
+        :param id: -
+        :param destination: The event destination.
+        :param configuration_set_event_destination_name: A name for the configuration set event destination. Default: - a CloudFormation generated name
+        :param enabled: Whether Amazon SES publishes events to this destination. Default: true
+        :param events: The type of email sending events to publish to the event destination. Default: - send all event types
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__969c3bbc0e7891ce9eb910e67644f0f9bcb29f65f5ec021df94eed425cb0d707)
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        options = ConfigurationSetEventDestinationOptions(
+            destination=destination,
+            configuration_set_event_destination_name=configuration_set_event_destination_name,
+            enabled=enabled,
+            events=events,
+        )
+
+        return typing.cast("ConfigurationSetEventDestination", jsii.invoke(self, "addEventDestination", [id, options]))
+
     @builtins.property
     @jsii.member(jsii_name="configurationSetName")
     def configuration_set_name(self) -> builtins.str:
@@ -9190,6 +9723,98 @@ class ConfigurationSet(
         return typing.cast(builtins.str, jsii.get(self, "configurationSetName"))
 
 
+@jsii.implements(IConfigurationSetEventDestination)
+class ConfigurationSetEventDestination(
+    _Resource_45bc6135,
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_ses.ConfigurationSetEventDestination",
+):
+    '''A configuration set event destination.
+
+    :exampleMetadata: fixture=_generated
+
+    Example::
+
+        # The code below shows an example of how to instantiate this type.
+        # The values are placeholders you should change.
+        from aws_cdk import aws_ses as ses
+        
+        # configuration_set: ses.ConfigurationSet
+        # event_destination: ses.EventDestination
+        
+        configuration_set_event_destination = ses.ConfigurationSetEventDestination(self, "MyConfigurationSetEventDestination",
+            configuration_set=configuration_set,
+            destination=event_destination,
+        
+            # the properties below are optional
+            configuration_set_event_destination_name="configurationSetEventDestinationName",
+            enabled=False,
+            events=[ses.EmailSendingEvent.SEND]
+        )
+    '''
+
+    def __init__(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        configuration_set: IConfigurationSet,
+        destination: EventDestination,
+        configuration_set_event_destination_name: typing.Optional[builtins.str] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        events: typing.Optional[typing.Sequence[EmailSendingEvent]] = None,
+    ) -> None:
+        '''
+        :param scope: -
+        :param id: -
+        :param configuration_set: The configuration set that contains the event destination.
+        :param destination: The event destination.
+        :param configuration_set_event_destination_name: A name for the configuration set event destination. Default: - a CloudFormation generated name
+        :param enabled: Whether Amazon SES publishes events to this destination. Default: true
+        :param events: The type of email sending events to publish to the event destination. Default: - send all event types
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__cf213dc05e866bbe3e9422388bafa084e54ef674803fa10657e5b96b908d6965)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        props = ConfigurationSetEventDestinationProps(
+            configuration_set=configuration_set,
+            destination=destination,
+            configuration_set_event_destination_name=configuration_set_event_destination_name,
+            enabled=enabled,
+            events=events,
+        )
+
+        jsii.create(self.__class__, self, [scope, id, props])
+
+    @jsii.member(jsii_name="fromConfigurationSetEventDestinationId")
+    @builtins.classmethod
+    def from_configuration_set_event_destination_id(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        configuration_set_event_destination_id: builtins.str,
+    ) -> IConfigurationSetEventDestination:
+        '''Use an existing configuration set.
+
+        :param scope: -
+        :param id: -
+        :param configuration_set_event_destination_id: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__4740349c6047d2ad783d767c6424ac19156d882d3534207b1440beda62370433)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument configuration_set_event_destination_id", value=configuration_set_event_destination_id, expected_type=type_hints["configuration_set_event_destination_id"])
+        return typing.cast(IConfigurationSetEventDestination, jsii.sinvoke(cls, "fromConfigurationSetEventDestinationId", [scope, id, configuration_set_event_destination_id]))
+
+    @builtins.property
+    @jsii.member(jsii_name="configurationSetEventDestinationId")
+    def configuration_set_event_destination_id(self) -> builtins.str:
+        '''The ID of the configuration set event destination.'''
+        return typing.cast(builtins.str, jsii.get(self, "configurationSetEventDestinationId"))
+
+
 @jsii.implements(IDedicatedIpPool)
 class DedicatedIpPool(
     _Resource_45bc6135,
@@ -9437,11 +10062,10 @@ class EmailIdentity(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # my_hosted_zone: route53.IPublicHostedZone
         
         
-        identity = ses.EmailIdentity(stack, "Identity",
+        identity = ses.EmailIdentity(self, "Identity",
             identity=ses.Identity.public_hosted_zone(my_hosted_zone),
             mail_from_domain="mail.cdk.dev"
         )
@@ -9601,7 +10225,12 @@ __all__ = [
     "CfnTemplateProps",
     "CfnVdmAttributes",
     "CfnVdmAttributesProps",
+    "CloudWatchDimension",
+    "CloudWatchDimensionSource",
     "ConfigurationSet",
+    "ConfigurationSetEventDestination",
+    "ConfigurationSetEventDestinationOptions",
+    "ConfigurationSetEventDestinationProps",
     "ConfigurationSetProps",
     "ConfigurationSetTlsPolicy",
     "DedicatedIpPool",
@@ -9614,7 +10243,10 @@ __all__ = [
     "EasyDkimSigningKeyLength",
     "EmailIdentity",
     "EmailIdentityProps",
+    "EmailSendingEvent",
+    "EventDestination",
     "IConfigurationSet",
+    "IConfigurationSetEventDestination",
     "IDedicatedIpPool",
     "IEmailIdentity",
     "IReceiptRule",
@@ -10451,6 +11083,36 @@ def _typecheckingstub__05720eed835713353d777877a75758a4e172dae5b79690ea107edcb7c
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__c718e80d3dd746209ff12fd14d08ce529bed18f85e0af362c1a2df8b5adc173a(
+    *,
+    default_value: builtins.str,
+    name: builtins.str,
+    source: CloudWatchDimensionSource,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__80b5162c2d2ea9081e7450a4b5db43212eaf82f433a217fb2be6e012977034b6(
+    *,
+    destination: EventDestination,
+    configuration_set_event_destination_name: typing.Optional[builtins.str] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    events: typing.Optional[typing.Sequence[EmailSendingEvent]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__dd3ac4f1af1f2fe9c11fa8894b2eae0f4b13c464b826cffda8b6937f4ab3e9c8(
+    *,
+    destination: EventDestination,
+    configuration_set_event_destination_name: typing.Optional[builtins.str] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    events: typing.Optional[typing.Sequence[EmailSendingEvent]] = None,
+    configuration_set: IConfigurationSet,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__fb010161f6c1e40b88122d9cb7754dae093e9cbe5bbfc72b19737729a4f4523d(
     *,
     configuration_set_name: typing.Optional[builtins.str] = None,
@@ -10530,6 +11192,18 @@ def _typecheckingstub__53e1ee2f3b565a95ed952bf4ad2ae80cb7388ac4bd51d6eab5219f8a7
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__48f9cce8b82649ed9874f37f0ed571721b324063ca98764a07bb10a451e9fe92(
+    dimensions: typing.Sequence[typing.Union[CloudWatchDimension, typing.Dict[builtins.str, typing.Any]]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__70dbe9528b7fbaa2cbed5b1def55a8c3126fbfed3ee256b878bbb907e4585c9c(
+    topic: _ITopic_9eca4852,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__1c0b08f3a2fda3c68a4ad951604e55664aeae1537b8b8eb996f95b6feedcf9b5(
     receipt_rule: IReceiptRule,
 ) -> None:
@@ -10792,6 +11466,38 @@ def _typecheckingstub__2ae99096d05b68163763ffbed7aafa034cd3a774f632bff2370d017f7
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__969c3bbc0e7891ce9eb910e67644f0f9bcb29f65f5ec021df94eed425cb0d707(
+    id: builtins.str,
+    *,
+    destination: EventDestination,
+    configuration_set_event_destination_name: typing.Optional[builtins.str] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    events: typing.Optional[typing.Sequence[EmailSendingEvent]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__cf213dc05e866bbe3e9422388bafa084e54ef674803fa10657e5b96b908d6965(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    configuration_set: IConfigurationSet,
+    destination: EventDestination,
+    configuration_set_event_destination_name: typing.Optional[builtins.str] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    events: typing.Optional[typing.Sequence[EmailSendingEvent]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__4740349c6047d2ad783d767c6424ac19156d882d3534207b1440beda62370433(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    configuration_set_event_destination_id: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__a4f168ec9aad173d023a8ac330a62f7c1ce87601f0a8876e8cbf35c7dcd89ead(
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,