aws-cdk-lib 2.184.1__py3-none-any.whl → 2.186.0__py3-none-any.whl

aws_cdk/aws_kinesisfirehose/__init__.py

@@ -84,8 +84,7 @@ Data must be provided via "direct put", ie., by using a `PutRecord` or
 
 Amazon Data Firehose supports multiple AWS and third-party services as destinations, including Amazon S3, Amazon Redshift, and more. You can find the full list of supported destination [here](https://docs.aws.amazon.com/firehose/latest/dev/create-destination.html).
 
-Currently in the AWS CDK, only S3 is implemented as an L2 construct destination. Other destinations can still be configured using L1 constructs. See [kinesisfirehose-destinations](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-kinesisfirehose-destinations-readme.html)
-for the implementations of these destinations.
+Currently in the AWS CDK, only S3 is implemented as an L2 construct destination. Other destinations can still be configured using L1 constructs.
 
 ### S3
 
@@ -221,7 +220,7 @@ limit of records per second (indicating data is flowing into your delivery strea
 than it is configured to process).
 
 CDK provides methods for accessing delivery stream metrics with default configuration,
-such as `metricIncomingBytes`, and `metricIncomingRecords` (see [`IDeliveryStream`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kinesisfirehose.IDeliveryStream.html)
+such as `metricIncomingBytes`, and `metricIncomingRecords` (see [`IDeliveryStream`](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-cdk-lib.aws_kinesisfirehose.IDeliveryStream.html)
 for a full list). CDK also provides a generic `metric` method that can be used to produce
 metric configurations for any metric provided by Amazon Data Firehose; the configurations
 are pre-populated with the correct dimensions for the delivery stream.
@@ -7880,7 +7879,7 @@ class CfnDeliveryStream(
             :param key_passphrase: Passphrase to decrypt the private key when the key is encrypted. For information, see `Using Key Pair Authentication & Key Rotation <https://docs.aws.amazon.com/https://docs.snowflake.com/en/user-guide/data-load-snowpipe-streaming-configuration#using-key-pair-authentication-key-rotation>`_ .
             :param meta_data_column_name: Specify a column name in the table, where the metadata information has to be loaded. When you enable this field, you will see the following column in the snowflake table, which differs based on the source type. For Direct PUT as source ``{ "firehoseDeliveryStreamName" : "streamname", "IngestionTime" : "timestamp" }`` For Kinesis Data Stream as source ``"kinesisStreamName" : "streamname", "kinesisShardId" : "Id", "kinesisPartitionKey" : "key", "kinesisSequenceNumber" : "1234", "subsequenceNumber" : "2334", "IngestionTime" : "timestamp" }``
             :param private_key: The private key used to encrypt your Snowflake client. For information, see `Using Key Pair Authentication & Key Rotation <https://docs.aws.amazon.com/https://docs.snowflake.com/en/user-guide/data-load-snowpipe-streaming-configuration#using-key-pair-authentication-key-rotation>`_ .
-            :param processing_configuration: Specifies configuration for Snowflake.
+            :param processing_configuration: 
             :param retry_options: The time period where Firehose will retry sending data to the chosen HTTP endpoint.
             :param s3_backup_mode: Choose an S3 backup mode.
             :param secrets_manager_configuration: The configuration that defines how you access secrets for Snowflake.
@@ -8184,8 +8183,7 @@ class CfnDeliveryStream(
         def processing_configuration(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDeliveryStream.ProcessingConfigurationProperty"]]:
-            '''Specifies configuration for Snowflake.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-kinesisfirehose-deliverystream-snowflakedestinationconfiguration.html#cfn-kinesisfirehose-deliverystream-snowflakedestinationconfiguration-processingconfiguration
             '''
             result = self._values.get("processing_configuration")
@@ -9403,7 +9401,7 @@ class CommonDestinationProps:
 
         :param logging_config: Configuration that determines whether to log errors during data transformation or delivery failures, and specifies the CloudWatch log group for storing error logs. Default: - errors will be logged and a log group will be created for you.
         :param processor: The data transformation that should be performed on the data before writing to the destination. Default: - no data transformation will occur.
-        :param role: The IAM role associated with this destination. Assumed by Kinesis Data Firehose to invoke processors and write to destinations Default: - a role will be created with default permissions.
+        :param role: The IAM role associated with this destination. Assumed by Amazon Data Firehose to invoke processors and write to destinations Default: - a role will be created with default permissions.
         :param s3_backup: The configuration for backing up source records to S3. Default: - source records will not be backed up to S3.
 
         :exampleMetadata: fixture=_generated
@@ -9483,7 +9481,7 @@ class CommonDestinationProps:
     def role(self) -> typing.Optional[_IRole_235f5d8e]:
         '''The IAM role associated with this destination.
 
-        Assumed by Kinesis Data Firehose to invoke processors and write to destinations
+        Assumed by Amazon Data Firehose to invoke processors and write to destinations
 
         :default: - a role will be created with default permissions.
         '''
@@ -9534,14 +9532,14 @@ class CommonDestinationS3Props:
         encryption_key: typing.Optional[_IKey_5f11635f] = None,
         error_output_prefix: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''Common properties for defining a backup, intermediary, or final S3 destination for a Kinesis Data Firehose delivery stream.
+        '''Common properties for defining a backup, intermediary, or final S3 destination for a Amazon Data Firehose delivery stream.
 
         :param buffering_interval: The length of time that Firehose buffers incoming data before delivering it to the S3 bucket. Minimum: Duration.seconds(0) Maximum: Duration.seconds(900) Default: Duration.seconds(300)
-        :param buffering_size: The size of the buffer that Kinesis Data Firehose uses for incoming data before delivering it to the S3 bucket. Minimum: Size.mebibytes(1) Maximum: Size.mebibytes(128) Default: Size.mebibytes(5)
-        :param compression: The type of compression that Kinesis Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket. The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket. Default: - UNCOMPRESSED
-        :param data_output_prefix: A prefix that Kinesis Data Firehose evaluates and adds to records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
+        :param buffering_size: The size of the buffer that Amazon Data Firehose uses for incoming data before delivering it to the S3 bucket. Minimum: Size.mebibytes(1) Maximum: Size.mebibytes(128) Default: Size.mebibytes(5)
+        :param compression: The type of compression that Amazon Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket. The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket. Default: - UNCOMPRESSED
+        :param data_output_prefix: A prefix that Amazon Data Firehose evaluates and adds to records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
         :param encryption_key: The AWS KMS key used to encrypt the data that it delivers to your Amazon S3 bucket. Default: - Data is not encrypted.
-        :param error_output_prefix: A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
+        :param error_output_prefix: A prefix that Amazon Data Firehose evaluates and adds to failed records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
 
         :exampleMetadata: fixture=_generated
 
@@ -9602,7 +9600,7 @@ class CommonDestinationS3Props:
 
     @builtins.property
     def buffering_size(self) -> typing.Optional[_Size_7b441c34]:
-        '''The size of the buffer that Kinesis Data Firehose uses for incoming data before delivering it to the S3 bucket.
+        '''The size of the buffer that Amazon Data Firehose uses for incoming data before delivering it to the S3 bucket.
 
         Minimum: Size.mebibytes(1)
         Maximum: Size.mebibytes(128)
@@ -9614,7 +9612,7 @@ class CommonDestinationS3Props:
 
     @builtins.property
     def compression(self) -> typing.Optional["Compression"]:
-        '''The type of compression that Kinesis Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket.
+        '''The type of compression that Amazon Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket.
 
         The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift
         destinations because they are not supported by the Amazon Redshift COPY operation
@@ -9627,7 +9625,7 @@ class CommonDestinationS3Props:
 
     @builtins.property
     def data_output_prefix(self) -> typing.Optional[builtins.str]:
-        '''A prefix that Kinesis Data Firehose evaluates and adds to records before writing them to S3.
+        '''A prefix that Amazon Data Firehose evaluates and adds to records before writing them to S3.
 
         This prefix appears immediately following the bucket name.
 
@@ -9649,7 +9647,7 @@ class CommonDestinationS3Props:
 
     @builtins.property
     def error_output_prefix(self) -> typing.Optional[builtins.str]:
-        '''A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3.
+        '''A prefix that Amazon Data Firehose evaluates and adds to failed records before writing them to S3.
 
         This prefix appears immediately following the bucket name.
 
@@ -9676,7 +9674,7 @@ class Compression(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_kinesisfirehose.Compression",
 ):
-    '''Possible compression options Kinesis Data Firehose can use to compress data on delivery.
+    '''Possible compression options Amazon Data Firehose can use to compress data on delivery.
 
     :exampleMetadata: infused
 
@@ -9751,7 +9749,7 @@ class DataProcessorBindOptions:
     def __init__(self, *, role: _IRole_235f5d8e) -> None:
         '''Options when binding a DataProcessor to a delivery stream destination.
 
-        :param role: The IAM role assumed by Kinesis Data Firehose to write to the destination that this DataProcessor will bind to.
+        :param role: The IAM role assumed by Amazon Data Firehose to write to the destination that this DataProcessor will bind to.
 
         :exampleMetadata: fixture=_generated
 
@@ -9777,7 +9775,7 @@ class DataProcessorBindOptions:
 
     @builtins.property
     def role(self) -> _IRole_235f5d8e:
-        '''The IAM role assumed by Kinesis Data Firehose to write to the destination that this DataProcessor will bind to.'''
+        '''The IAM role assumed by Amazon Data Firehose to write to the destination that this DataProcessor will bind to.'''
         result = self._values.get("role")
         assert result is not None, "Required property 'role' is missing"
         return typing.cast(_IRole_235f5d8e, result)
@@ -9967,9 +9965,9 @@ class DataProcessorProps:
     ) -> None:
         '''Configure the data processor.
 
-        :param buffer_interval: The length of time Kinesis Data Firehose will buffer incoming data before calling the processor. s Default: Duration.minutes(1)
-        :param buffer_size: The amount of incoming data Kinesis Data Firehose will buffer before calling the processor. Default: Size.mebibytes(3)
-        :param retries: The number of times Kinesis Data Firehose will retry the processor invocation after a failure due to network timeout or invocation limits. Default: 3
+        :param buffer_interval: The length of time Amazon Data Firehose will buffer incoming data before calling the processor. s Default: Duration.minutes(1)
+        :param buffer_size: The amount of incoming data Amazon Data Firehose will buffer before calling the processor. Default: Size.mebibytes(3)
+        :param retries: The number of times Amazon Data Firehose will retry the processor invocation after a failure due to network timeout or invocation limits. Default: 3
 
         :exampleMetadata: infused
 
@@ -10010,7 +10008,7 @@ class DataProcessorProps:
 
     @builtins.property
     def buffer_interval(self) -> typing.Optional[_Duration_4839e8c3]:
-        '''The length of time Kinesis Data Firehose will buffer incoming data before calling the processor.
+        '''The length of time Amazon Data Firehose will buffer incoming data before calling the processor.
 
         s
 
@@ -10021,7 +10019,7 @@ class DataProcessorProps:
 
     @builtins.property
     def buffer_size(self) -> typing.Optional[_Size_7b441c34]:
-        '''The amount of incoming data Kinesis Data Firehose will buffer before calling the processor.
+        '''The amount of incoming data Amazon Data Firehose will buffer before calling the processor.
 
         :default: Size.mebibytes(3)
         '''
@@ -10030,7 +10028,7 @@ class DataProcessorProps:
 
     @builtins.property
     def retries(self) -> typing.Optional[jsii.Number]:
-        '''The number of times Kinesis Data Firehose will retry the processor invocation after a failure due to network timeout or invocation limits.
+        '''The number of times Amazon Data Firehose will retry the processor invocation after a failure due to network timeout or invocation limits.
 
         :default: 3
         '''
@@ -10070,7 +10068,7 @@ class DeliveryStreamAttributes:
 
         :param delivery_stream_arn: The ARN of the delivery stream. At least one of deliveryStreamArn and deliveryStreamName must be provided. Default: - derived from ``deliveryStreamName``.
         :param delivery_stream_name: The name of the delivery stream. At least one of deliveryStreamName and deliveryStreamArn must be provided. Default: - derived from ``deliveryStreamArn``.
-        :param role: The IAM role associated with this delivery stream. Assumed by Kinesis Data Firehose to read from sources and encrypt data server-side. Default: - the imported stream cannot be granted access to other resources as an ``iam.IGrantable``.
+        :param role: The IAM role associated with this delivery stream. Assumed by Amazon Data Firehose to read from sources and encrypt data server-side. Default: - the imported stream cannot be granted access to other resources as an ``iam.IGrantable``.
 
         :exampleMetadata: fixture=_generated
 
@@ -10128,7 +10126,7 @@ class DeliveryStreamAttributes:
     def role(self) -> typing.Optional[_IRole_235f5d8e]:
         '''The IAM role associated with this delivery stream.
 
-        Assumed by Kinesis Data Firehose to read from sources and encrypt data server-side.
+        Assumed by Amazon Data Firehose to read from sources and encrypt data server-side.
 
         :default: - the imported stream cannot be granted access to other resources as an ``iam.IGrantable``.
         '''
@@ -10173,29 +10171,31 @@ class DeliveryStreamProps:
         :param destination: The destination that this delivery stream will deliver data to.
         :param delivery_stream_name: A name for the delivery stream. Default: - a name is generated by CloudFormation.
         :param encryption: Indicates the type of customer master key (CMK) to use for server-side encryption, if any. Default: StreamEncryption.unencrypted()
-        :param role: The IAM role associated with this delivery stream. Assumed by Kinesis Data Firehose to read from sources and encrypt data server-side. Default: - a role will be created with default permissions.
+        :param role: The IAM role associated with this delivery stream. Assumed by Amazon Data Firehose to read from sources and encrypt data server-side. Default: - a role will be created with default permissions.
         :param source: The Kinesis data stream to use as a source for this delivery stream. Default: - data must be written to the delivery stream via a direct put.
 
         :exampleMetadata: infused
 
         Example::
 
-            import aws_cdk.aws_kinesisfirehose as firehose
-            
-            
-            bucket = s3.Bucket(self, "MyBucket")
-            stream = firehose.DeliveryStream(self, "MyStream",
-                destination=firehose.S3Bucket(bucket)
+            # bucket: s3.Bucket
+            # Provide a Lambda function that will transform records before delivery, with custom
+            # buffering and retry configuration
+            lambda_function = lambda_.Function(self, "Processor",
+                runtime=lambda_.Runtime.NODEJS_LATEST,
+                handler="index.handler",
+                code=lambda_.Code.from_asset(path.join(__dirname, "process-records"))
             )
-            
-            topic_rule = iot.TopicRule(self, "TopicRule",
-                sql=iot.IotSql.from_string_as_ver20160323("SELECT * FROM 'device/+/data'"),
-                actions=[
-                    actions.FirehosePutRecordAction(stream,
-                        batch_mode=True,
-                        record_separator=actions.FirehoseRecordSeparator.NEWLINE
-                    )
-                ]
+            lambda_processor = firehose.LambdaFunctionProcessor(lambda_function,
+                buffer_interval=Duration.minutes(5),
+                buffer_size=Size.mebibytes(5),
+                retries=5
+            )
+            s3_destination = firehose.S3Bucket(bucket,
+                processor=lambda_processor
+            )
+            firehose.DeliveryStream(self, "Delivery Stream",
+                destination=s3_destination
             )
         '''
         if __debug__:
@@ -10246,7 +10246,7 @@ class DeliveryStreamProps:
     def role(self) -> typing.Optional[_IRole_235f5d8e]:
         '''The IAM role associated with this delivery stream.
 
-        Assumed by Kinesis Data Firehose to read from sources and encrypt data server-side.
+        Assumed by Amazon Data Firehose to read from sources and encrypt data server-side.
 
         :default: - a role will be created with default permissions.
         '''
@@ -10322,7 +10322,7 @@ class DestinationConfig:
         dependables: typing.Optional[typing.Sequence[_constructs_77d1e7e8.IDependable]] = None,
         extended_s3_destination_configuration: typing.Optional[typing.Union[CfnDeliveryStream.ExtendedS3DestinationConfigurationProperty, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
-        '''A Kinesis Data Firehose delivery stream destination configuration.
+        '''An Amazon Data Firehose delivery stream destination configuration.
 
         :param dependables: Any resources that were created by the destination when binding it to the stack that must be deployed before the delivery stream is deployed. Default: []
         :param extended_s3_destination_configuration: S3 destination configuration properties. Default: - S3 destination is not used.
@@ -10540,11 +10540,11 @@ class DestinationS3BackupProps(CommonDestinationS3Props):
         S3 backup is available for all destinations, regardless of whether the final destination is S3 or not.
 
         :param buffering_interval: The length of time that Firehose buffers incoming data before delivering it to the S3 bucket. Minimum: Duration.seconds(0) Maximum: Duration.seconds(900) Default: Duration.seconds(300)
-        :param buffering_size: The size of the buffer that Kinesis Data Firehose uses for incoming data before delivering it to the S3 bucket. Minimum: Size.mebibytes(1) Maximum: Size.mebibytes(128) Default: Size.mebibytes(5)
-        :param compression: The type of compression that Kinesis Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket. The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket. Default: - UNCOMPRESSED
-        :param data_output_prefix: A prefix that Kinesis Data Firehose evaluates and adds to records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
+        :param buffering_size: The size of the buffer that Amazon Data Firehose uses for incoming data before delivering it to the S3 bucket. Minimum: Size.mebibytes(1) Maximum: Size.mebibytes(128) Default: Size.mebibytes(5)
+        :param compression: The type of compression that Amazon Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket. The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket. Default: - UNCOMPRESSED
+        :param data_output_prefix: A prefix that Amazon Data Firehose evaluates and adds to records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
         :param encryption_key: The AWS KMS key used to encrypt the data that it delivers to your Amazon S3 bucket. Default: - Data is not encrypted.
-        :param error_output_prefix: A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
+        :param error_output_prefix: A prefix that Amazon Data Firehose evaluates and adds to failed records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
         :param bucket: The S3 bucket that will store data and failed records. Default: - If ``mode`` is set to ``BackupMode.ALL`` or ``BackupMode.FAILED``, a bucket will be created for you.
         :param logging_config: Configuration that determines whether to log errors during data transformation or delivery failures, and specifies the CloudWatch log group for storing error logs. Default: - errors will be logged and a log group will be created for you.
         :param mode: Indicates the mode by which incoming records should be backed up to S3, if any. If ``bucket`` is provided, this will be implicitly set to ``BackupMode.ALL``. Default: - If ``bucket`` is provided, the default will be ``BackupMode.ALL``. Otherwise, source records are not backed up to S3.
@@ -10630,7 +10630,7 @@ class DestinationS3BackupProps(CommonDestinationS3Props):
 
     @builtins.property
     def buffering_size(self) -> typing.Optional[_Size_7b441c34]:
-        '''The size of the buffer that Kinesis Data Firehose uses for incoming data before delivering it to the S3 bucket.
+        '''The size of the buffer that Amazon Data Firehose uses for incoming data before delivering it to the S3 bucket.
 
         Minimum: Size.mebibytes(1)
         Maximum: Size.mebibytes(128)
@@ -10642,7 +10642,7 @@ class DestinationS3BackupProps(CommonDestinationS3Props):
 
     @builtins.property
     def compression(self) -> typing.Optional[Compression]:
-        '''The type of compression that Kinesis Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket.
+        '''The type of compression that Amazon Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket.
 
         The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift
         destinations because they are not supported by the Amazon Redshift COPY operation
@@ -10655,7 +10655,7 @@ class DestinationS3BackupProps(CommonDestinationS3Props):
 
     @builtins.property
     def data_output_prefix(self) -> typing.Optional[builtins.str]:
-        '''A prefix that Kinesis Data Firehose evaluates and adds to records before writing them to S3.
+        '''A prefix that Amazon Data Firehose evaluates and adds to records before writing them to S3.
 
         This prefix appears immediately following the bucket name.
 
@@ -10677,7 +10677,7 @@ class DestinationS3BackupProps(CommonDestinationS3Props):
 
     @builtins.property
     def error_output_prefix(self) -> typing.Optional[builtins.str]:
-        '''A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3.
+        '''A prefix that Amazon Data Firehose evaluates and adds to failed records before writing them to S3.
 
         This prefix appears immediately following the bucket name.
 
@@ -10734,7 +10734,7 @@ class DestinationS3BackupProps(CommonDestinationS3Props):
 
 @jsii.interface(jsii_type="aws-cdk-lib.aws_kinesisfirehose.IDataProcessor")
 class IDataProcessor(typing_extensions.Protocol):
-    '''A data processor that Kinesis Data Firehose will call to transform records before delivering data.'''
+    '''A data processor that Amazon Data Firehose will call to transform records before delivering data.'''
 
     @builtins.property
     @jsii.member(jsii_name="props")
@@ -10755,13 +10755,13 @@ class IDataProcessor(typing_extensions.Protocol):
         necessary configuration to register as a processor.
 
         :param scope: -
-        :param role: The IAM role assumed by Kinesis Data Firehose to write to the destination that this DataProcessor will bind to.
+        :param role: The IAM role assumed by Amazon Data Firehose to write to the destination that this DataProcessor will bind to.
         '''
         ...
 
 
 class _IDataProcessorProxy:
-    '''A data processor that Kinesis Data Firehose will call to transform records before delivering data.'''
+    '''A data processor that Amazon Data Firehose will call to transform records before delivering data.'''
 
     __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_kinesisfirehose.IDataProcessor"
 
@@ -10784,7 +10784,7 @@ class _IDataProcessorProxy:
         necessary configuration to register as a processor.
 
         :param scope: -
-        :param role: The IAM role assumed by Kinesis Data Firehose to write to the destination that this DataProcessor will bind to.
+        :param role: The IAM role assumed by Amazon Data Firehose to write to the destination that this DataProcessor will bind to.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4720a6b97c475eae9ec0d65aca8250b00f57d45f0efb2368b8df6d486162c508)
@@ -10804,7 +10804,7 @@ class IDeliveryStream(
     _IConnectable_10015a05,
     typing_extensions.Protocol,
 ):
-    '''Represents a Kinesis Data Firehose delivery stream.'''
+    '''Represents an Amazon Data Firehose delivery stream.'''
 
     @builtins.property
     @jsii.member(jsii_name="deliveryStreamArn")
@@ -10924,7 +10924,7 @@ class IDeliveryStream(
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional[_Unit_61bc6f70] = None,
     ) -> _Metric_e396a4dc:
-        '''Metric for the age (from getting into Kinesis Data Firehose to now) of the oldest record in Kinesis Data Firehose.
+        '''Metric for the age (from getting into Amazon Data Firehose to now) of the oldest record in Amazon Data Firehose.
 
         Any record older than this age has been delivered to the Amazon S3 bucket for backup.
 
@@ -11045,7 +11045,7 @@ class _IDeliveryStreamProxy(
     jsii.proxy_for(_IGrantable_71c4f5de), # type: ignore[misc]
     jsii.proxy_for(_IConnectable_10015a05), # type: ignore[misc]
 ):
-    '''Represents a Kinesis Data Firehose delivery stream.'''
+    '''Represents an Amazon Data Firehose delivery stream.'''
 
     __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_kinesisfirehose.IDeliveryStream"
 
@@ -11203,7 +11203,7 @@ class _IDeliveryStreamProxy(
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional[_Unit_61bc6f70] = None,
     ) -> _Metric_e396a4dc:
-        '''Metric for the age (from getting into Kinesis Data Firehose to now) of the oldest record in Kinesis Data Firehose.
+        '''Metric for the age (from getting into Amazon Data Firehose to now) of the oldest record in Amazon Data Firehose.
 
         Any record older than this age has been delivered to the Amazon S3 bucket for backup.
 
@@ -11376,11 +11376,11 @@ typing.cast(typing.Any, IDeliveryStream).__jsii_proxy_class__ = lambda : _IDeliv
 
 @jsii.interface(jsii_type="aws-cdk-lib.aws_kinesisfirehose.IDestination")
 class IDestination(typing_extensions.Protocol):
-    '''A Kinesis Data Firehose delivery stream destination.'''
+    '''An Amazon Data Firehose delivery stream destination.'''
 
     @jsii.member(jsii_name="bind")
     def bind(self, scope: _constructs_77d1e7e8.Construct) -> DestinationConfig:
-        '''Binds this destination to the Kinesis Data Firehose delivery stream.
+        '''Binds this destination to the Amazon Data Firehose delivery stream.
 
         Implementers should use this method to bind resources to the stack and initialize values using the provided stream.
 
@@ -11390,13 +11390,13 @@ class IDestination(typing_extensions.Protocol):
 
 
 class _IDestinationProxy:
-    '''A Kinesis Data Firehose delivery stream destination.'''
+    '''An Amazon Data Firehose delivery stream destination.'''
 
     __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_kinesisfirehose.IDestination"
 
     @jsii.member(jsii_name="bind")
     def bind(self, scope: _constructs_77d1e7e8.Construct) -> DestinationConfig:
-        '''Binds this destination to the Kinesis Data Firehose delivery stream.
+        '''Binds this destination to the Amazon Data Firehose delivery stream.
 
         Implementers should use this method to bind resources to the stack and initialize values using the provided stream.
 
@@ -11473,7 +11473,7 @@ typing.cast(typing.Any, ILoggingConfig).__jsii_proxy_class__ = lambda : _ILoggin
 
 @jsii.interface(jsii_type="aws-cdk-lib.aws_kinesisfirehose.ISource")
 class ISource(typing_extensions.Protocol):
-    '''An interface for defining a source that can be used in a Kinesis Data Firehose delivery stream.'''
+    '''An interface for defining a source that can be used in an Amazon Data Firehose delivery stream.'''
 
     @jsii.member(jsii_name="grantRead")
     def grant_read(self, grantee: _IGrantable_71c4f5de) -> _Grant_a7ae64f8:
@@ -11488,7 +11488,7 @@ class ISource(typing_extensions.Protocol):
 
 
 class _ISourceProxy:
-    '''An interface for defining a source that can be used in a Kinesis Data Firehose delivery stream.'''
+    '''An interface for defining a source that can be used in an Amazon Data Firehose delivery stream.'''
 
     __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_kinesisfirehose.ISource"
 
@@ -11515,7 +11515,7 @@ class KinesisStreamSource(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_kinesisfirehose.KinesisStreamSource",
 ):
-    '''A Kinesis Data Firehose delivery stream source.
+    '''An Amazon Data Firehose delivery stream source.
 
     :exampleMetadata: infused
 
@@ -11598,9 +11598,9 @@ class LambdaFunctionProcessor(
     ) -> None:
         '''
         :param lambda_function: -
-        :param buffer_interval: The length of time Kinesis Data Firehose will buffer incoming data before calling the processor. s Default: Duration.minutes(1)
-        :param buffer_size: The amount of incoming data Kinesis Data Firehose will buffer before calling the processor. Default: Size.mebibytes(3)
-        :param retries: The number of times Kinesis Data Firehose will retry the processor invocation after a failure due to network timeout or invocation limits. Default: 3
+        :param buffer_interval: The length of time Amazon Data Firehose will buffer incoming data before calling the processor. s Default: Duration.minutes(1)
+        :param buffer_size: The amount of incoming data Amazon Data Firehose will buffer before calling the processor. Default: Size.mebibytes(3)
+        :param retries: The number of times Amazon Data Firehose will retry the processor invocation after a failure due to network timeout or invocation limits. Default: 3
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__c9ef06af75a5f9424b9a83d955544e1a8c769bb828e54b77e5dcec4ddd0f9154)
@@ -11624,7 +11624,7 @@ class LambdaFunctionProcessor(
         necessary configuration to register as a processor.
 
         :param _scope: -
-        :param role: The IAM role assumed by Kinesis Data Firehose to write to the destination that this DataProcessor will bind to.
+        :param role: The IAM role assumed by Amazon Data Firehose to write to the destination that this DataProcessor will bind to.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__393c41d8ae2fe5acab13fd70fff9f4778e727adfd78b86d20820f067071490de)
@@ -11645,7 +11645,7 @@ class S3Bucket(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_kinesisfirehose.S3Bucket",
 ):
-    '''An S3 bucket destination for data from a Kinesis Data Firehose delivery stream.
+    '''An S3 bucket destination for data from an Amazon Data Firehose delivery stream.
 
     :exampleMetadata: infused
 
@@ -11688,14 +11688,14 @@ class S3Bucket(
         '''
         :param bucket: -
         :param buffering_interval: The length of time that Firehose buffers incoming data before delivering it to the S3 bucket. Minimum: Duration.seconds(0) Maximum: Duration.seconds(900) Default: Duration.seconds(300)
-        :param buffering_size: The size of the buffer that Kinesis Data Firehose uses for incoming data before delivering it to the S3 bucket. Minimum: Size.mebibytes(1) Maximum: Size.mebibytes(128) Default: Size.mebibytes(5)
-        :param compression: The type of compression that Kinesis Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket. The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket. Default: - UNCOMPRESSED
-        :param data_output_prefix: A prefix that Kinesis Data Firehose evaluates and adds to records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
+        :param buffering_size: The size of the buffer that Amazon Data Firehose uses for incoming data before delivering it to the S3 bucket. Minimum: Size.mebibytes(1) Maximum: Size.mebibytes(128) Default: Size.mebibytes(5)
+        :param compression: The type of compression that Amazon Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket. The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket. Default: - UNCOMPRESSED
+        :param data_output_prefix: A prefix that Amazon Data Firehose evaluates and adds to records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
         :param encryption_key: The AWS KMS key used to encrypt the data that it delivers to your Amazon S3 bucket. Default: - Data is not encrypted.
-        :param error_output_prefix: A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
+        :param error_output_prefix: A prefix that Amazon Data Firehose evaluates and adds to failed records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
         :param logging_config: Configuration that determines whether to log errors during data transformation or delivery failures, and specifies the CloudWatch log group for storing error logs. Default: - errors will be logged and a log group will be created for you.
         :param processor: The data transformation that should be performed on the data before writing to the destination. Default: - no data transformation will occur.
-        :param role: The IAM role associated with this destination. Assumed by Kinesis Data Firehose to invoke processors and write to destinations Default: - a role will be created with default permissions.
+        :param role: The IAM role associated with this destination. Assumed by Amazon Data Firehose to invoke processors and write to destinations Default: - a role will be created with default permissions.
         :param s3_backup: The configuration for backing up source records to S3. Default: - source records will not be backed up to S3.
         '''
         if __debug__:
@@ -11718,7 +11718,7 @@ class S3Bucket(
 
     @jsii.member(jsii_name="bind")
     def bind(self, scope: _constructs_77d1e7e8.Construct) -> DestinationConfig:
-        '''Binds this destination to the Kinesis Data Firehose delivery stream.
+        '''Binds this destination to the Amazon Data Firehose delivery stream.
 
         Implementers should use this method to bind resources to the stack and initialize values using the provided stream.
 
@@ -11763,17 +11763,17 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
         role: typing.Optional[_IRole_235f5d8e] = None,
         s3_backup: typing.Optional[typing.Union[DestinationS3BackupProps, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
-        '''Props for defining an S3 destination of a Kinesis Data Firehose delivery stream.
+        '''Props for defining an S3 destination of an Amazon Data Firehose delivery stream.
 
         :param buffering_interval: The length of time that Firehose buffers incoming data before delivering it to the S3 bucket. Minimum: Duration.seconds(0) Maximum: Duration.seconds(900) Default: Duration.seconds(300)
-        :param buffering_size: The size of the buffer that Kinesis Data Firehose uses for incoming data before delivering it to the S3 bucket. Minimum: Size.mebibytes(1) Maximum: Size.mebibytes(128) Default: Size.mebibytes(5)
-        :param compression: The type of compression that Kinesis Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket. The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket. Default: - UNCOMPRESSED
-        :param data_output_prefix: A prefix that Kinesis Data Firehose evaluates and adds to records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
+        :param buffering_size: The size of the buffer that Amazon Data Firehose uses for incoming data before delivering it to the S3 bucket. Minimum: Size.mebibytes(1) Maximum: Size.mebibytes(128) Default: Size.mebibytes(5)
+        :param compression: The type of compression that Amazon Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket. The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket. Default: - UNCOMPRESSED
+        :param data_output_prefix: A prefix that Amazon Data Firehose evaluates and adds to records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
         :param encryption_key: The AWS KMS key used to encrypt the data that it delivers to your Amazon S3 bucket. Default: - Data is not encrypted.
-        :param error_output_prefix: A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
+        :param error_output_prefix: A prefix that Amazon Data Firehose evaluates and adds to failed records before writing them to S3. This prefix appears immediately following the bucket name. Default: "YYYY/MM/DD/HH"
         :param logging_config: Configuration that determines whether to log errors during data transformation or delivery failures, and specifies the CloudWatch log group for storing error logs. Default: - errors will be logged and a log group will be created for you.
         :param processor: The data transformation that should be performed on the data before writing to the destination. Default: - no data transformation will occur.
-        :param role: The IAM role associated with this destination. Assumed by Kinesis Data Firehose to invoke processors and write to destinations Default: - a role will be created with default permissions.
+        :param role: The IAM role associated with this destination. Assumed by Amazon Data Firehose to invoke processors and write to destinations Default: - a role will be created with default permissions.
         :param s3_backup: The configuration for backing up source records to S3. Default: - source records will not be backed up to S3.
 
         :exampleMetadata: infused
@@ -11850,7 +11850,7 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
 
     @builtins.property
     def buffering_size(self) -> typing.Optional[_Size_7b441c34]:
-        '''The size of the buffer that Kinesis Data Firehose uses for incoming data before delivering it to the S3 bucket.
+        '''The size of the buffer that Amazon Data Firehose uses for incoming data before delivering it to the S3 bucket.
 
         Minimum: Size.mebibytes(1)
         Maximum: Size.mebibytes(128)
@@ -11862,7 +11862,7 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
 
     @builtins.property
     def compression(self) -> typing.Optional[Compression]:
-        '''The type of compression that Kinesis Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket.
+        '''The type of compression that Amazon Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket.
 
         The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift
         destinations because they are not supported by the Amazon Redshift COPY operation
@@ -11875,7 +11875,7 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
 
     @builtins.property
     def data_output_prefix(self) -> typing.Optional[builtins.str]:
-        '''A prefix that Kinesis Data Firehose evaluates and adds to records before writing them to S3.
+        '''A prefix that Amazon Data Firehose evaluates and adds to records before writing them to S3.
 
         This prefix appears immediately following the bucket name.
 
@@ -11897,7 +11897,7 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
 
     @builtins.property
     def error_output_prefix(self) -> typing.Optional[builtins.str]:
-        '''A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3.
+        '''A prefix that Amazon Data Firehose evaluates and adds to failed records before writing them to S3.
 
         This prefix appears immediately following the bucket name.
 
@@ -11930,7 +11930,7 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
     def role(self) -> typing.Optional[_IRole_235f5d8e]:
         '''The IAM role associated with this destination.
 
-        Assumed by Kinesis Data Firehose to invoke processors and write to destinations
+        Assumed by Amazon Data Firehose to invoke processors and write to destinations
 
         :default: - a role will be created with default permissions.
         '''
@@ -11962,7 +11962,7 @@ class StreamEncryption(
     metaclass=jsii.JSIIAbstractClass,
     jsii_type="aws-cdk-lib.aws_kinesisfirehose.StreamEncryption",
 ):
-    '''Represents server-side encryption for a Kinesis Firehose Delivery Stream.
+    '''Represents server-side encryption for an Amazon Firehose Delivery Stream.
 
     :exampleMetadata: infused
 
@@ -12019,7 +12019,7 @@ class StreamEncryption(
     @builtins.property
     @jsii.member(jsii_name="type")
     def type(self) -> "StreamEncryptionType":
-        '''The type of server-side encryption for the Kinesis Firehose delivery stream.'''
+        '''The type of server-side encryption for the Amazon Firehose delivery stream.'''
         return typing.cast("StreamEncryptionType", jsii.get(self, "type"))
 
     @builtins.property
@@ -12054,29 +12054,31 @@ class DeliveryStream(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_kinesisfirehose.DeliveryStream",
 ):
-    '''Create a Kinesis Data Firehose delivery stream.
+    '''Create a Amazon Data Firehose delivery stream.
 
     :resource: AWS::KinesisFirehose::DeliveryStream
     :exampleMetadata: infused
 
     Example::
 
-        import aws_cdk.aws_kinesisfirehose as firehose
-        
-        
-        bucket = s3.Bucket(self, "MyBucket")
-        stream = firehose.DeliveryStream(self, "MyStream",
-            destination=firehose.S3Bucket(bucket)
+        # bucket: s3.Bucket
+        # Provide a Lambda function that will transform records before delivery, with custom
+        # buffering and retry configuration
+        lambda_function = lambda_.Function(self, "Processor",
+            runtime=lambda_.Runtime.NODEJS_LATEST,
+            handler="index.handler",
+            code=lambda_.Code.from_asset(path.join(__dirname, "process-records"))
         )
-        
-        topic_rule = iot.TopicRule(self, "TopicRule",
-            sql=iot.IotSql.from_string_as_ver20160323("SELECT * FROM 'device/+/data'"),
-            actions=[
-                actions.FirehosePutRecordAction(stream,
-                    batch_mode=True,
-                    record_separator=actions.FirehoseRecordSeparator.NEWLINE
-                )
-            ]
+        lambda_processor = firehose.LambdaFunctionProcessor(lambda_function,
+            buffer_interval=Duration.minutes(5),
+            buffer_size=Size.mebibytes(5),
+            retries=5
+        )
+        s3_destination = firehose.S3Bucket(bucket,
+            processor=lambda_processor
+        )
+        firehose.DeliveryStream(self, "Delivery Stream",
+            destination=s3_destination
         )
     '''
 
@@ -12097,7 +12099,7 @@ class DeliveryStream(
         :param destination: The destination that this delivery stream will deliver data to.
         :param delivery_stream_name: A name for the delivery stream. Default: - a name is generated by CloudFormation.
         :param encryption: Indicates the type of customer master key (CMK) to use for server-side encryption, if any. Default: StreamEncryption.unencrypted()
-        :param role: The IAM role associated with this delivery stream. Assumed by Kinesis Data Firehose to read from sources and encrypt data server-side. Default: - a role will be created with default permissions.
+        :param role: The IAM role associated with this delivery stream. Assumed by Amazon Data Firehose to read from sources and encrypt data server-side. Default: - a role will be created with default permissions.
         :param source: The Kinesis data stream to use as a source for this delivery stream. Default: - data must be written to the delivery stream via a direct put.
         '''
         if __debug__:
@@ -12152,7 +12154,7 @@ class DeliveryStream(
         :param id: -
         :param delivery_stream_arn: The ARN of the delivery stream. At least one of deliveryStreamArn and deliveryStreamName must be provided. Default: - derived from ``deliveryStreamName``.
         :param delivery_stream_name: The name of the delivery stream. At least one of deliveryStreamName and deliveryStreamArn must be provided. Default: - derived from ``deliveryStreamArn``.
-        :param role: The IAM role associated with this delivery stream. Assumed by Kinesis Data Firehose to read from sources and encrypt data server-side. Default: - the imported stream cannot be granted access to other resources as an ``iam.IGrantable``.
+        :param role: The IAM role associated with this delivery stream. Assumed by Amazon Data Firehose to read from sources and encrypt data server-side. Default: - the imported stream cannot be granted access to other resources as an ``iam.IGrantable``.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__60d49cb1de4cae1a83d89ae7d419d2e7a17f1c8a25478897973ca006cf1f5066)
@@ -12323,7 +12325,7 @@ class DeliveryStream(
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional[_Unit_61bc6f70] = None,
     ) -> _Metric_e396a4dc:
-        '''Metric for the age (from getting into Kinesis Data Firehose to now) of the oldest record in Kinesis Data Firehose.
+        '''Metric for the age (from getting into Amazon Data Firehose to now) of the oldest record in Amazon Data Firehose.
 
         Any record older than this age has been delivered to the Amazon S3 bucket for backup.
 
@@ -12493,7 +12495,7 @@ class DeliveryStream(
     @builtins.property
     @jsii.member(jsii_name="connections")
     def connections(self) -> _Connections_0f31fce8:
-        '''Network connections between Kinesis Data Firehose and other resources, i.e. Redshift cluster.'''
+        '''Network connections between Amazon Data Firehose and other resources, i.e. Redshift cluster.'''
         return typing.cast(_Connections_0f31fce8, jsii.get(self, "connections"))
 
     @builtins.property