aws-cdk-lib 2.178.2__py3-none-any.whl → 2.180.0__py3-none-any.whl

aws_cdk/aws_ses/__init__.py

@@ -147,7 +147,7 @@ ses.ConfigurationSet(self, "ConfigurationSet",
 )
 ```
 
-Use `addEventDestination()` to publish email sending events to Amazon SNS or Amazon CloudWatch:
+Use `addEventDestination()` to publish email sending events to Amazon SNS, Amazon CloudWatch, Amazon Kinesis Firehose or Amazon EventBridge:
 
 ```python
 # my_configuration_set: ses.ConfigurationSet
@@ -159,6 +159,48 @@ my_configuration_set.add_event_destination("ToSns",
 )
 ```
 
+**Note**: For EventBridge, you must specify the default EventBus:
+
+```python
+import aws_cdk.aws_events as events
+
+# my_configuration_set: ses.ConfigurationSet
+
+
+bus = events.EventBus.from_event_bus_name(self, "EventBus", "default")
+
+my_configuration_set.add_event_destination("ToEventBus",
+    destination=ses.EventDestination.event_bus(bus)
+)
+```
+
+For Firehose, if you don't specify IAM Role ARN for Amazon SES to send events. An IAM Role will be created automatically following https://docs.aws.amazon.com/ses/latest/dg/event-publishing-add-event-destination-firehose.html.
+
+```python
+import aws_cdk.aws_iam as iam
+import aws_cdk.aws_kinesisfirehose as firehose
+
+# my_configuration_set: ses.ConfigurationSet
+# firehose_delivery_stream: firehose.IDeliveryStream
+# iam_role: iam.IRole
+
+
+# Create IAM Role automatically
+my_configuration_set.add_event_destination("ToFirehose",
+    destination=ses.EventDestination.firehose_delivery_stream(
+        delivery_stream=firehose_delivery_stream
+    )
+)
+
+# Specify your IAM Role
+my_configuration_set.add_event_destination("ToFirehose",
+    destination=ses.EventDestination.firehose_delivery_stream(
+        delivery_stream=firehose_delivery_stream,
+        role=iam_role
+    )
+)
+```
+
 ### Override account-level suppression list settings
 
 You can customize account-level suppression list separately for different configuration sets by overriding it
@@ -344,7 +386,13 @@ from .. import (
     TagManager as _TagManager_0a598cb3,
     TreeInspector as _TreeInspector_488e0dd5,
 )
-from ..aws_iam import Grant as _Grant_a7ae64f8, IGrantable as _IGrantable_71c4f5de
+from ..aws_events import IEventBus as _IEventBus_88d13111
+from ..aws_iam import (
+    Grant as _Grant_a7ae64f8,
+    IGrantable as _IGrantable_71c4f5de,
+    IRole as _IRole_235f5d8e,
+)
+from ..aws_kinesisfirehose import IDeliveryStream as _IDeliveryStream_8f118861
 from ..aws_route53 import IPublicHostedZone as _IPublicHostedZone_9b6e7da4
 from ..aws_sns import ITopic as _ITopic_9eca4852
 
@@ -12698,12 +12746,15 @@ class ConfigurationSetEventDestinationOptions:
 
         Example::
 
+            import aws_cdk.aws_events as events
+            
             # my_configuration_set: ses.ConfigurationSet
-            # my_topic: sns.Topic
             
             
-            my_configuration_set.add_event_destination("ToSns",
-                destination=ses.EventDestination.sns_topic(my_topic)
+            bus = events.EventBus.from_event_bus_name(self, "EventBus", "default")
+            
+            my_configuration_set.add_event_destination("ToEventBus",
+                destination=ses.EventDestination.event_bus(bus)
             )
         '''
         if __debug__:
@@ -13760,12 +13811,15 @@ class EventDestination(
 
     Example::
 
+        import aws_cdk.aws_events as events
+        
         # my_configuration_set: ses.ConfigurationSet
-        # my_topic: sns.Topic
         
         
-        my_configuration_set.add_event_destination("ToSns",
-            destination=ses.EventDestination.sns_topic(my_topic)
+        bus = events.EventBus.from_event_bus_name(self, "EventBus", "default")
+        
+        my_configuration_set.add_event_destination("ToEventBus",
+            destination=ses.EventDestination.event_bus(bus)
         )
     '''
 
@@ -13787,6 +13841,37 @@ class EventDestination(
             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="eventBus")
+    @builtins.classmethod
+    def event_bus(cls, event_bus: _IEventBus_88d13111) -> "EventDestination":
+        '''Use Event Bus as event destination.
+
+        :param event_bus: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__78ca2ceff9eadb6d2fd3c462d34cb7f67a24ade525c2a3315a2817370e1d2567)
+            check_type(argname="argument event_bus", value=event_bus, expected_type=type_hints["event_bus"])
+        return typing.cast("EventDestination", jsii.sinvoke(cls, "eventBus", [event_bus]))
+
+    @jsii.member(jsii_name="firehoseDeliveryStream")
+    @builtins.classmethod
+    def firehose_delivery_stream(
+        cls,
+        *,
+        delivery_stream: _IDeliveryStream_8f118861,
+        role: typing.Optional[_IRole_235f5d8e] = None,
+    ) -> "EventDestination":
+        '''Use Firehose Delivery Stream as event destination.
+
+        :param delivery_stream: The Amazon Kinesis Data Firehose stream that the Amazon SES API v2 sends email events to.
+        :param role: The IAM role that the Amazon SES API v2 uses to send email events to the Amazon Kinesis Data Firehose stream. Default: - Create IAM Role for Kinesis Data Firehose Delivery stream
+        '''
+        stream = FirehoseDeliveryStreamDestination(
+            delivery_stream=delivery_stream, role=role
+        )
+
+        return typing.cast("EventDestination", jsii.sinvoke(cls, "firehoseDeliveryStream", [stream]))
+
     @jsii.member(jsii_name="snsTopic")
     @builtins.classmethod
     def sns_topic(cls, topic: _ITopic_9eca4852) -> "EventDestination":
@@ -13799,6 +13884,16 @@ class EventDestination(
             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="bus")
+    @abc.abstractmethod
+    def bus(self) -> typing.Optional[_IEventBus_88d13111]:
+        '''Use Event Bus as event destination.
+
+        :default: - do not send events to Event bus
+        '''
+        ...
+
     @builtins.property
     @jsii.member(jsii_name="dimensions")
     @abc.abstractmethod
@@ -13809,6 +13904,16 @@ class EventDestination(
         '''
         ...
 
+    @builtins.property
+    @jsii.member(jsii_name="stream")
+    @abc.abstractmethod
+    def stream(self) -> typing.Optional["FirehoseDeliveryStreamDestination"]:
+        '''Use Firehose Delivery Stream.
+
+        :default: - do not send events to Firehose Delivery Stream
+        '''
+        ...
+
     @builtins.property
     @jsii.member(jsii_name="topic")
     @abc.abstractmethod
@@ -13821,6 +13926,15 @@ class EventDestination(
 
 
 class _EventDestinationProxy(EventDestination):
+    @builtins.property
+    @jsii.member(jsii_name="bus")
+    def bus(self) -> typing.Optional[_IEventBus_88d13111]:
+        '''Use Event Bus as event destination.
+
+        :default: - do not send events to Event bus
+        '''
+        return typing.cast(typing.Optional[_IEventBus_88d13111], jsii.get(self, "bus"))
+
     @builtins.property
     @jsii.member(jsii_name="dimensions")
     def dimensions(self) -> typing.Optional[typing.List[CloudWatchDimension]]:
@@ -13830,6 +13944,15 @@ class _EventDestinationProxy(EventDestination):
         '''
         return typing.cast(typing.Optional[typing.List[CloudWatchDimension]], jsii.get(self, "dimensions"))
 
+    @builtins.property
+    @jsii.member(jsii_name="stream")
+    def stream(self) -> typing.Optional["FirehoseDeliveryStreamDestination"]:
+        '''Use Firehose Delivery Stream.
+
+        :default: - do not send events to Firehose Delivery Stream
+        '''
+        return typing.cast(typing.Optional["FirehoseDeliveryStreamDestination"], jsii.get(self, "stream"))
+
     @builtins.property
     @jsii.member(jsii_name="topic")
     def topic(self) -> typing.Optional[_ITopic_9eca4852]:
@@ -13843,6 +13966,88 @@ class _EventDestinationProxy(EventDestination):
 typing.cast(typing.Any, EventDestination).__jsii_proxy_class__ = lambda : _EventDestinationProxy
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_ses.FirehoseDeliveryStreamDestination",
+    jsii_struct_bases=[],
+    name_mapping={"delivery_stream": "deliveryStream", "role": "role"},
+)
+class FirehoseDeliveryStreamDestination:
+    def __init__(
+        self,
+        *,
+        delivery_stream: _IDeliveryStream_8f118861,
+        role: typing.Optional[_IRole_235f5d8e] = None,
+    ) -> None:
+        '''An object that defines an Amazon Kinesis Data Firehose destination for email events.
+
+        :param delivery_stream: The Amazon Kinesis Data Firehose stream that the Amazon SES API v2 sends email events to.
+        :param role: The IAM role that the Amazon SES API v2 uses to send email events to the Amazon Kinesis Data Firehose stream. Default: - Create IAM Role for Kinesis Data Firehose Delivery stream
+
+        :exampleMetadata: infused
+
+        Example::
+
+            import aws_cdk.aws_iam as iam
+            import aws_cdk.aws_kinesisfirehose as firehose
+            
+            # my_configuration_set: ses.ConfigurationSet
+            # firehose_delivery_stream: firehose.IDeliveryStream
+            # iam_role: iam.IRole
+            
+            
+            # Create IAM Role automatically
+            my_configuration_set.add_event_destination("ToFirehose",
+                destination=ses.EventDestination.firehose_delivery_stream(
+                    delivery_stream=firehose_delivery_stream
+                )
+            )
+            
+            # Specify your IAM Role
+            my_configuration_set.add_event_destination("ToFirehose",
+                destination=ses.EventDestination.firehose_delivery_stream(
+                    delivery_stream=firehose_delivery_stream,
+                    role=iam_role
+                )
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__25e298d77ea0f34cfbae7db26e4f74efd5a1ddd1fa1c691226c8fa211cb24464)
+            check_type(argname="argument delivery_stream", value=delivery_stream, expected_type=type_hints["delivery_stream"])
+            check_type(argname="argument role", value=role, expected_type=type_hints["role"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "delivery_stream": delivery_stream,
+        }
+        if role is not None:
+            self._values["role"] = role
+
+    @builtins.property
+    def delivery_stream(self) -> _IDeliveryStream_8f118861:
+        '''The Amazon Kinesis Data Firehose stream that the Amazon SES API v2 sends email events to.'''
+        result = self._values.get("delivery_stream")
+        assert result is not None, "Required property 'delivery_stream' is missing"
+        return typing.cast(_IDeliveryStream_8f118861, result)
+
+    @builtins.property
+    def role(self) -> typing.Optional[_IRole_235f5d8e]:
+        '''The IAM role that the Amazon SES API v2 uses to send email events to the Amazon Kinesis Data Firehose stream.
+
+        :default: - Create IAM Role for Kinesis Data Firehose Delivery stream
+        '''
+        result = self._values.get("role")
+        return typing.cast(typing.Optional[_IRole_235f5d8e], 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 "FirehoseDeliveryStreamDestination(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.interface(jsii_type="aws-cdk-lib.aws_ses.IConfigurationSet")
 class IConfigurationSet(_IResource_c80c4260, typing_extensions.Protocol):
     '''A configuration set.'''
@@ -16763,6 +16968,7 @@ __all__ = [
     "EmailIdentityProps",
     "EmailSendingEvent",
     "EventDestination",
+    "FirehoseDeliveryStreamDestination",
     "IConfigurationSet",
     "IConfigurationSetEventDestination",
     "IDedicatedIpPool",
@@ -18470,12 +18676,26 @@ def _typecheckingstub__48f9cce8b82649ed9874f37f0ed571721b324063ca98764a07bb10a45
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__78ca2ceff9eadb6d2fd3c462d34cb7f67a24ade525c2a3315a2817370e1d2567(
+    event_bus: _IEventBus_88d13111,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__70dbe9528b7fbaa2cbed5b1def55a8c3126fbfed3ee256b878bbb907e4585c9c(
     topic: _ITopic_9eca4852,
 ) -> None:
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__25e298d77ea0f34cfbae7db26e4f74efd5a1ddd1fa1c691226c8fa211cb24464(
+    *,
+    delivery_stream: _IDeliveryStream_8f118861,
+    role: typing.Optional[_IRole_235f5d8e] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__6eb2e4383fa830ca0d609c782e4234141a31536edcdc3259b3ad6d4f1a87c702(
     grantee: _IGrantable_71c4f5de,
     *actions: builtins.str,

aws_cdk/aws_ssm/__init__.py

@@ -333,7 +333,7 @@ class CfnAssociation(
         :param apply_only_at_cron_interval: By default, when you create a new association, the system runs it immediately after it is created and then according to the schedule you specified. Specify this option if you don't want an association to run immediately after you create it. This parameter is not supported for rate expressions.
         :param association_name: Specify a descriptive name for the association.
         :param automation_target_parameter_name: Choose the parameter that will define how your automation will branch out. This target is required for associations that use an Automation runbook and target resources by using rate controls. Automation is a tool in AWS Systems Manager .
-        :param calendar_names: The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your associations are gated under. The associations only run when that Change Calendar is open. For more information, see `AWS Systems Manager Change Calendar <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar>`_ .
+        :param calendar_names: The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your associations are gated under. The associations only run when that Change Calendar is open. For more information, see `AWS Systems Manager Change Calendar <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar>`_ in the *AWS Systems Manager User Guide* .
         :param compliance_severity: The severity level that is assigned to the association.
         :param document_version: The version of the SSM document to associate with the target. .. epigraph:: Note the following important information. - State Manager doesn't support running associations that use a new version of a document if that document is shared from another account. State Manager always runs the ``default`` version of a document if shared from another account, even though the Systems Manager console shows that a new version was processed. If you want to run an association using a new version of a document shared form another account, you must set the document version to ``default`` . - ``DocumentVersion`` is not valid for documents owned by AWS , such as ``AWS-RunPatchBaseline`` or ``AWS-UpdateSSMAgent`` . If you specify ``DocumentVersion`` for an AWS document, the system returns the following error: "Error occurred during operation 'CreateAssociation'." (RequestToken: , HandlerErrorCode: GeneralServiceException).
         :param instance_id: The ID of the instance that the SSM document is associated with. You must specify the ``InstanceId`` or ``Targets`` property. .. epigraph:: ``InstanceId`` has been deprecated. To specify an instance ID for an association, use the ``Targets`` parameter. If you use the parameter ``InstanceId`` , you cannot use the parameters ``AssociationName`` , ``DocumentVersion`` , ``MaxErrors`` , ``MaxConcurrency`` , ``OutputLocation`` , or ``ScheduleExpression`` . To use these parameters, you must use the ``Targets`` parameter.
@@ -938,7 +938,7 @@ class CfnAssociationProps:
         :param apply_only_at_cron_interval: By default, when you create a new association, the system runs it immediately after it is created and then according to the schedule you specified. Specify this option if you don't want an association to run immediately after you create it. This parameter is not supported for rate expressions.
         :param association_name: Specify a descriptive name for the association.
         :param automation_target_parameter_name: Choose the parameter that will define how your automation will branch out. This target is required for associations that use an Automation runbook and target resources by using rate controls. Automation is a tool in AWS Systems Manager .
-        :param calendar_names: The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your associations are gated under. The associations only run when that Change Calendar is open. For more information, see `AWS Systems Manager Change Calendar <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar>`_ .
+        :param calendar_names: The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your associations are gated under. The associations only run when that Change Calendar is open. For more information, see `AWS Systems Manager Change Calendar <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar>`_ in the *AWS Systems Manager User Guide* .
         :param compliance_severity: The severity level that is assigned to the association.
         :param document_version: The version of the SSM document to associate with the target. .. epigraph:: Note the following important information. - State Manager doesn't support running associations that use a new version of a document if that document is shared from another account. State Manager always runs the ``default`` version of a document if shared from another account, even though the Systems Manager console shows that a new version was processed. If you want to run an association using a new version of a document shared form another account, you must set the document version to ``default`` . - ``DocumentVersion`` is not valid for documents owned by AWS , such as ``AWS-RunPatchBaseline`` or ``AWS-UpdateSSMAgent`` . If you specify ``DocumentVersion`` for an AWS document, the system returns the following error: "Error occurred during operation 'CreateAssociation'." (RequestToken: , HandlerErrorCode: GeneralServiceException).
         :param instance_id: The ID of the instance that the SSM document is associated with. You must specify the ``InstanceId`` or ``Targets`` property. .. epigraph:: ``InstanceId`` has been deprecated. To specify an instance ID for an association, use the ``Targets`` parameter. If you use the parameter ``InstanceId`` , you cannot use the parameters ``AssociationName`` , ``DocumentVersion`` , ``MaxErrors`` , ``MaxConcurrency`` , ``OutputLocation`` , or ``ScheduleExpression`` . To use these parameters, you must use the ``Targets`` parameter.
@@ -1104,7 +1104,7 @@ class CfnAssociationProps:
     def calendar_names(self) -> typing.Optional[typing.List[builtins.str]]:
         '''The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your associations are gated under.
 
-        The associations only run when that Change Calendar is open. For more information, see `AWS Systems Manager Change Calendar <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar>`_ .
+        The associations only run when that Change Calendar is open. For more information, see `AWS Systems Manager Change Calendar <https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar>`_ in the *AWS Systems Manager User Guide* .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ssm-association.html#cfn-ssm-association-calendarnames
         '''
@@ -6522,8 +6522,7 @@ class CfnResourceDataSync(
     @builtins.property
     @jsii.member(jsii_name="attrSyncName")
     def attr_sync_name(self) -> builtins.str:
-        '''The name of the resource data sync.
-
+        '''
         :cloudformationAttribute: SyncName
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrSyncName"))