aws-cdk-lib 2.142.1__py3-none-any.whl → 2.143.1__py3-none-any.whl

aws_cdk/aws_events_targets/__init__.py

@@ -575,7 +575,7 @@ from typeguard import check_type
 from .._jsii import *
 
 import constructs as _constructs_77d1e7e8
-from .. import Duration as _Duration_4839e8c3
+from .. import Duration as _Duration_4839e8c3, IResource as _IResource_c80c4260
 from ..aws_apigateway import (
     IRestApi as _IRestApi_1f02523d, RestApi as _RestApi_777c8238
 )
@@ -2030,13 +2030,68 @@ class EventBusProps:
         )
 
 
+@jsii.interface(jsii_type="aws-cdk-lib.aws_events_targets.IDeliveryStream")
+class IDeliveryStream(_IResource_c80c4260, typing_extensions.Protocol):
+    '''Represents a Kinesis Data Firehose delivery stream.'''
+
+    @builtins.property
+    @jsii.member(jsii_name="deliveryStreamArn")
+    def delivery_stream_arn(self) -> builtins.str:
+        '''The ARN of the delivery stream.
+
+        :attribute: true
+        '''
+        ...
+
+    @builtins.property
+    @jsii.member(jsii_name="deliveryStreamName")
+    def delivery_stream_name(self) -> builtins.str:
+        '''The name of the delivery stream.
+
+        :attribute: true
+        '''
+        ...
+
+
+class _IDeliveryStreamProxy(
+    jsii.proxy_for(_IResource_c80c4260), # type: ignore[misc]
+):
+    '''Represents a Kinesis Data Firehose delivery stream.'''
+
+    __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_events_targets.IDeliveryStream"
+
+    @builtins.property
+    @jsii.member(jsii_name="deliveryStreamArn")
+    def delivery_stream_arn(self) -> builtins.str:
+        '''The ARN of the delivery stream.
+
+        :attribute: true
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "deliveryStreamArn"))
+
+    @builtins.property
+    @jsii.member(jsii_name="deliveryStreamName")
+    def delivery_stream_name(self) -> builtins.str:
+        '''The name of the delivery stream.
+
+        :attribute: true
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "deliveryStreamName"))
+
+# Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
+typing.cast(typing.Any, IDeliveryStream).__jsii_proxy_class__ = lambda : _IDeliveryStreamProxy
+
+
 @jsii.implements(_IRuleTarget_7a91f454)
 class KinesisFirehoseStream(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_events_targets.KinesisFirehoseStream",
 ):
-    '''Customize the Firehose Stream Event Target.
+    '''(deprecated) Customize the Firehose Stream Event Target.
+
+    :deprecated: Use KinesisFirehoseStreamV2
 
+    :stability: deprecated
     :exampleMetadata: fixture=_generated
 
     Example::
@@ -2064,6 +2119,8 @@ class KinesisFirehoseStream(
         '''
         :param stream: -
         :param message: The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
+
+        :stability: deprecated
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__c6dba8ed5e351380147a927ce30f4c9095bc69a54a2de45039c2a1d8275dc88c)
@@ -2078,10 +2135,12 @@ class KinesisFirehoseStream(
         _rule: _IRule_af9e3d28,
         _id: typing.Optional[builtins.str] = None,
     ) -> _RuleTargetConfig_4e70fe03:
-        '''Returns a RuleTarget that can be used to trigger this Firehose Stream as a result from a Event Bridge event.
+        '''(deprecated) Returns a RuleTarget that can be used to trigger this Firehose Stream as a result from a Event Bridge event.
 
         :param _rule: -
         :param _id: -
+
+        :stability: deprecated
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__b38a65da97645536b57df6537ab7a5b06cf8910d4235008699171e7ced62c584)
@@ -2150,6 +2209,65 @@ class KinesisFirehoseStreamProps:
         )
 
 
+@jsii.implements(_IRuleTarget_7a91f454)
+class KinesisFirehoseStreamV2(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_events_targets.KinesisFirehoseStreamV2",
+):
+    '''Customize the Firehose Stream Event Target V2 to support L2 Kinesis Delivery Stream instead of L1 Cfn Kinesis Delivery Stream.
+
+    :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_events as events
+        from aws_cdk import aws_events_targets as events_targets
+        
+        # delivery_stream: events_targets.IDeliveryStream
+        # rule_target_input: events.RuleTargetInput
+        
+        kinesis_firehose_stream_v2 = events_targets.KinesisFirehoseStreamV2(delivery_stream,
+            message=rule_target_input
+        )
+    '''
+
+    def __init__(
+        self,
+        stream: IDeliveryStream,
+        *,
+        message: typing.Optional[_RuleTargetInput_6beca786] = None,
+    ) -> None:
+        '''
+        :param stream: -
+        :param message: The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__e8230487c5e79599a4ad63af004c2c8350c2b25e209491350274d38019afa418)
+            check_type(argname="argument stream", value=stream, expected_type=type_hints["stream"])
+        props = KinesisFirehoseStreamProps(message=message)
+
+        jsii.create(self.__class__, self, [stream, props])
+
+    @jsii.member(jsii_name="bind")
+    def bind(
+        self,
+        _rule: _IRule_af9e3d28,
+        _id: typing.Optional[builtins.str] = None,
+    ) -> _RuleTargetConfig_4e70fe03:
+        '''Returns a RuleTarget that can be used to trigger this Firehose Stream as a result from a Event Bridge event.
+
+        :param _rule: -
+        :param _id: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__3467ab0e593ed64d775dafc3b3fc1b1835fa2853c7ee8685668bf081dd189e44)
+            check_type(argname="argument _rule", value=_rule, expected_type=type_hints["_rule"])
+            check_type(argname="argument _id", value=_id, expected_type=type_hints["_id"])
+        return typing.cast(_RuleTargetConfig_4e70fe03, jsii.invoke(self, "bind", [_rule, _id]))
+
+
 @jsii.implements(_IRuleTarget_7a91f454)
 class KinesisStream(
     metaclass=jsii.JSIIMeta,
@@ -2608,6 +2726,8 @@ class SnsTopic(
 ):
     '''Use an SNS topic as a target for Amazon EventBridge rules.
 
+    If the topic is imported the required permissions to publish to that topic need to be set manually.
+
     Example::
 
         # publish to an SNS topic every time code is committed
@@ -5066,8 +5186,10 @@ __all__ = [
     "EcsTaskProps",
     "EventBus",
     "EventBusProps",
+    "IDeliveryStream",
     "KinesisFirehoseStream",
     "KinesisFirehoseStreamProps",
+    "KinesisFirehoseStreamV2",
     "KinesisStream",
     "KinesisStreamProps",
     "LambdaFunction",
@@ -5331,6 +5453,21 @@ def _typecheckingstub__81d5bbf50681705e8fea422823feb918a4c9bd4be7914a6acf6200ac6
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__e8230487c5e79599a4ad63af004c2c8350c2b25e209491350274d38019afa418(
+    stream: IDeliveryStream,
+    *,
+    message: typing.Optional[_RuleTargetInput_6beca786] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__3467ab0e593ed64d775dafc3b3fc1b1835fa2853c7ee8685668bf081dd189e44(
+    _rule: _IRule_af9e3d28,
+    _id: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__47a9d917a1971c5aa11b68bf823d9f34a57a7b1e7653b0f82809c06309cac1a6(
     stream: _IStream_4e2457d2,
     *,