aws-cdk-lib 2.187.0__py3-none-any.whl → 2.188.0__py3-none-any.whl

aws_cdk/aws_identitystore/__init__.py

@@ -72,7 +72,7 @@ class CfnGroup(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_identitystore.CfnGroup",
 ):
-    '''A group object that contains the metadata and attributes for a specified group.
+    '''A group object, which contains a specified group’s metadata and attributes.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-identitystore-group.html
     :cloudformationResource: AWS::IdentityStore::Group
@@ -107,7 +107,7 @@ class CfnGroup(
         :param id: Construct identifier for this resource (unique in its scope).
         :param display_name: The display name value for the group. The length limit is 1,024 characters. This value can consist of letters, accented characters, symbols, numbers, punctuation, tab, new line, carriage return, space, and nonbreaking space in this attribute. This value is specified at the time the group is created and stored as an attribute of the group object in the identity store. Prefix search supports a maximum of 1,000 characters for the string.
         :param identity_store_id: The globally unique identifier for the identity store.
-        :param description: A string containing a description of the specified group.
+        :param description: A string containing the description of the group.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__37e27ff46dfa4082cad1981cc4ade1e2a9ce445cf9aad4a8eb75e162b9b429f1)
@@ -154,7 +154,7 @@ class CfnGroup(
     @builtins.property
     @jsii.member(jsii_name="attrGroupId")
     def attr_group_id(self) -> builtins.str:
-        '''The identifier for a group in the identity store.
+        '''The identifier of the newly created group in the identity store.
 
         :cloudformationAttribute: GroupId
         '''
@@ -194,7 +194,7 @@ class CfnGroup(
     @builtins.property
     @jsii.member(jsii_name="description")
     def description(self) -> typing.Optional[builtins.str]:
-        '''A string containing a description of the specified group.'''
+        '''A string containing the description of the group.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "description"))
 
     @description.setter
@@ -248,7 +248,7 @@ class CfnGroupMembership(
         :param id: Construct identifier for this resource (unique in its scope).
         :param group_id: The identifier for a group in the identity store.
         :param identity_store_id: The globally unique identifier for the identity store.
-        :param member_id: An object that contains the identifier of a group member. Setting the ``UserID`` field to the specific identifier for a user indicates that the user is a member of the group.
+        :param member_id: An object containing the identifier of a group member. Setting the ``MemberId`` 's ``UserId`` field to a specific User's ID indicates that user is a member of the group.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__76d55a804ce565c6f3a413944bff86b3236786318808951cf53ad4eff71316db)
@@ -293,7 +293,7 @@ class CfnGroupMembership(
     @builtins.property
     @jsii.member(jsii_name="attrMembershipId")
     def attr_membership_id(self) -> builtins.str:
-        '''The identifier for a ``GroupMembership`` object in an identity store.
+        '''The identifier for a ``GroupMembership`` in the identity store.
 
         :cloudformationAttribute: MembershipId
         '''
@@ -335,7 +335,7 @@ class CfnGroupMembership(
     def member_id(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, "CfnGroupMembership.MemberIdProperty"]:
-        '''An object that contains the identifier of a group member.'''
+        '''An object containing the identifier of a group member.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnGroupMembership.MemberIdProperty"], jsii.get(self, "memberId"))
 
     @member_id.setter
@@ -355,7 +355,9 @@ class CfnGroupMembership(
     )
     class MemberIdProperty:
         def __init__(self, *, user_id: builtins.str) -> None:
-            '''An object containing the identifier of a group member.
+            '''An object that contains the identifier of a group member.
+
+            Setting the ``UserID`` field to the specific identifier for a user indicates that the user is a member of the group.
 
             :param user_id: An object containing the identifiers of resources that can be members.
 
@@ -422,7 +424,7 @@ class CfnGroupMembershipProps:
 
         :param group_id: The identifier for a group in the identity store.
         :param identity_store_id: The globally unique identifier for the identity store.
-        :param member_id: An object that contains the identifier of a group member. Setting the ``UserID`` field to the specific identifier for a user indicates that the user is a member of the group.
+        :param member_id: An object containing the identifier of a group member. Setting the ``MemberId`` 's ``UserId`` field to a specific User's ID indicates that user is a member of the group.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-identitystore-groupmembership.html
         :exampleMetadata: fixture=_generated
@@ -476,9 +478,9 @@ class CfnGroupMembershipProps:
     def member_id(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, CfnGroupMembership.MemberIdProperty]:
-        '''An object that contains the identifier of a group member.
+        '''An object containing the identifier of a group member.
 
-        Setting the ``UserID`` field to the specific identifier for a user indicates that the user is a member of the group.
+        Setting the ``MemberId`` 's ``UserId`` field to a specific User's ID indicates that user is a member of the group.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-identitystore-groupmembership.html#cfn-identitystore-groupmembership-memberid
         '''
@@ -519,7 +521,7 @@ class CfnGroupProps:
 
         :param display_name: The display name value for the group. The length limit is 1,024 characters. This value can consist of letters, accented characters, symbols, numbers, punctuation, tab, new line, carriage return, space, and nonbreaking space in this attribute. This value is specified at the time the group is created and stored as an attribute of the group object in the identity store. Prefix search supports a maximum of 1,000 characters for the string.
         :param identity_store_id: The globally unique identifier for the identity store.
-        :param description: A string containing a description of the specified group.
+        :param description: A string containing the description of the group.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-identitystore-group.html
         :exampleMetadata: fixture=_generated
@@ -576,7 +578,7 @@ class CfnGroupProps:
 
     @builtins.property
     def description(self) -> typing.Optional[builtins.str]:
-        '''A string containing a description of the specified group.
+        '''A string containing the description of the group.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-identitystore-group.html#cfn-identitystore-group-description
         '''

aws_cdk/aws_kinesisfirehose/__init__.py

@@ -116,6 +116,17 @@ s3_destination = firehose.S3Bucket(bucket,
 See: [Custom S3 Prefixes](https://docs.aws.amazon.com/firehose/latest/dev/s3-prefixes.html)
 in the *Amazon Data Firehose Developer Guide*.
 
+To override default file extension appended by Data Format Conversion or S3 compression features, specify `fileExtension`.
+
+```python
+# bucket: s3.Bucket
+
+s3_destination = firehose.S3Bucket(bucket,
+    compression=firehose.Compression.GZIP,
+    file_extension=".json.gz"
+)
+```
+
 ## Server-side Encryption
 
 Enabling server-side encryption (SSE) requires Amazon Data Firehose to encrypt all data
@@ -484,6 +495,7 @@ delivery_stream = firehose.DeliveryStream(stack, "DeliveryStream",
         compression=firehose.Compression.GZIP,
         data_output_prefix="regularPrefix",
         error_output_prefix="errorPrefix",
+        file_extension=".log.gz",
         buffering_interval=cdk.Duration.seconds(60),
         buffering_size=cdk.Size.mebibytes(1),
         encryption_key=key,
@@ -11674,6 +11686,7 @@ class S3Bucket(
         self,
         bucket: _IBucket_42e086fd,
         *,
+        file_extension: typing.Optional[builtins.str] = None,
         buffering_interval: typing.Optional[_Duration_4839e8c3] = None,
         buffering_size: typing.Optional[_Size_7b441c34] = None,
         compression: typing.Optional[Compression] = None,
@@ -11687,6 +11700,7 @@ class S3Bucket(
     ) -> None:
         '''
         :param bucket: -
+        :param file_extension: Specify a file extension. It will override the default file extension appended by Data Format Conversion or S3 compression features such as ``.parquet`` or ``.gz``. File extension must start with a period (``.``) and can contain allowed characters: ``0-9a-z!-_.*'()``. Default: - The default file extension appended by Data Format Conversion or S3 compression features
         :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 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
@@ -11702,6 +11716,7 @@ class S3Bucket(
             type_hints = typing.get_type_hints(_typecheckingstub__a2eaf455255fc260033aa24d456779f4b21172e8b4cf2c51f6355f415c9f3ccd)
             check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
         props = S3BucketProps(
+            file_extension=file_extension,
             buffering_interval=buffering_interval,
             buffering_size=buffering_size,
             compression=compression,
@@ -11746,6 +11761,7 @@ class S3Bucket(
         "processor": "processor",
         "role": "role",
         "s3_backup": "s3Backup",
+        "file_extension": "fileExtension",
     },
 )
 class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
@@ -11762,6 +11778,7 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
         processor: typing.Optional[IDataProcessor] = None,
         role: typing.Optional[_IRole_235f5d8e] = None,
         s3_backup: typing.Optional[typing.Union[DestinationS3BackupProps, typing.Dict[builtins.str, typing.Any]]] = None,
+        file_extension: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Props for defining an S3 destination of an Amazon Data Firehose delivery stream.
 
@@ -11775,6 +11792,7 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
         :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 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.
+        :param file_extension: Specify a file extension. It will override the default file extension appended by Data Format Conversion or S3 compression features such as ``.parquet`` or ``.gz``. File extension must start with a period (``.``) and can contain allowed characters: ``0-9a-z!-_.*'()``. Default: - The default file extension appended by Data Format Conversion or S3 compression features
 
         :exampleMetadata: infused
 
@@ -11814,6 +11832,7 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
             check_type(argname="argument processor", value=processor, expected_type=type_hints["processor"])
             check_type(argname="argument role", value=role, expected_type=type_hints["role"])
             check_type(argname="argument s3_backup", value=s3_backup, expected_type=type_hints["s3_backup"])
+            check_type(argname="argument file_extension", value=file_extension, expected_type=type_hints["file_extension"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if buffering_interval is not None:
             self._values["buffering_interval"] = buffering_interval
@@ -11835,6 +11854,8 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
             self._values["role"] = role
         if s3_backup is not None:
             self._values["s3_backup"] = s3_backup
+        if file_extension is not None:
+            self._values["file_extension"] = file_extension
 
     @builtins.property
     def buffering_interval(self) -> typing.Optional[_Duration_4839e8c3]:
@@ -11946,6 +11967,21 @@ class S3BucketProps(CommonDestinationS3Props, CommonDestinationProps):
         result = self._values.get("s3_backup")
         return typing.cast(typing.Optional[DestinationS3BackupProps], result)
 
+    @builtins.property
+    def file_extension(self) -> typing.Optional[builtins.str]:
+        '''Specify a file extension.
+
+        It will override the default file extension appended by Data Format Conversion or S3 compression features such as ``.parquet`` or ``.gz``.
+
+        File extension must start with a period (``.``) and can contain allowed characters: ``0-9a-z!-_.*'()``.
+
+        :default: - The default file extension appended by Data Format Conversion or S3 compression features
+
+        :see: https://docs.aws.amazon.com/firehose/latest/dev/create-destination.html#create-destination-s3
+        '''
+        result = self._values.get("file_extension")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -13621,6 +13657,7 @@ def _typecheckingstub__393c41d8ae2fe5acab13fd70fff9f4778e727adfd78b86d20820f0670
 def _typecheckingstub__a2eaf455255fc260033aa24d456779f4b21172e8b4cf2c51f6355f415c9f3ccd(
     bucket: _IBucket_42e086fd,
     *,
+    file_extension: typing.Optional[builtins.str] = None,
     buffering_interval: typing.Optional[_Duration_4839e8c3] = None,
     buffering_size: typing.Optional[_Size_7b441c34] = None,
     compression: typing.Optional[Compression] = None,
@@ -13653,6 +13690,7 @@ def _typecheckingstub__04b12dc503479d22af2396c4df8d38c37536719187eef6ddd01c18b52
     processor: typing.Optional[IDataProcessor] = None,
     role: typing.Optional[_IRole_235f5d8e] = None,
     s3_backup: typing.Optional[typing.Union[DestinationS3BackupProps, typing.Dict[builtins.str, typing.Any]]] = None,
+    file_extension: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass

aws_cdk/aws_lambda_event_sources/__init__.py

@@ -2648,7 +2648,7 @@ class StreamEventSource(
         :param on_failure: An Amazon S3, Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
-        :param retry_attempts: Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source. Default: -1
+        :param retry_attempts: Maximum number of retry attempts. Set to -1 for infinite retries (until the record expires in the event source). Valid Range: -1 (infinite) or 0 to 10000 Default: -1 (infinite retries)
         :param tumbling_window: The size of the tumbling windows to group records sent to DynamoDB or Kinesis Valid Range: 0 - 15 minutes. Default: - None
         :param starting_position: Where to begin consuming the stream.
         :param batch_size: The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records. Valid Range: - Minimum value of 1 - Maximum value of: - 1000 for ``DynamoEventSource`` - 10000 for ``KinesisEventSource``, ``ManagedKafkaEventSource`` and ``SelfManagedKafkaEventSource`` Default: 100
@@ -2844,7 +2844,7 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
         :param on_failure: An Amazon S3, Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
-        :param retry_attempts: Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source. Default: -1
+        :param retry_attempts: Maximum number of retry attempts. Set to -1 for infinite retries (until the record expires in the event source). Valid Range: -1 (infinite) or 0 to 10000 Default: -1 (infinite retries)
         :param tumbling_window: The size of the tumbling windows to group records sent to DynamoDB or Kinesis Valid Range: 0 - 15 minutes. Default: - None
 
         :exampleMetadata: fixture=_generated
@@ -3097,13 +3097,13 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
 
     @builtins.property
     def retry_attempts(self) -> typing.Optional[jsii.Number]:
-        '''Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000.
+        '''Maximum number of retry attempts.
 
-        The default value is -1, which sets the maximum number of retries to infinite.
-        When MaximumRetryAttempts is infinite, Lambda retries failed records until
-        the record expires in the event source.
+        Set to -1 for infinite retries (until the record expires in the event source).
 
-        :default: -1
+        Valid Range: -1 (infinite) or 0 to 10000
+
+        :default: -1 (infinite retries)
         '''
         result = self._values.get("retry_attempts")
         return typing.cast(typing.Optional[jsii.Number], result)
@@ -3191,7 +3191,7 @@ class DynamoEventSource(
         :param on_failure: An Amazon S3, Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
-        :param retry_attempts: Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source. Default: -1
+        :param retry_attempts: Maximum number of retry attempts. Set to -1 for infinite retries (until the record expires in the event source). Valid Range: -1 (infinite) or 0 to 10000 Default: -1 (infinite retries)
         :param tumbling_window: The size of the tumbling windows to group records sent to DynamoDB or Kinesis Valid Range: 0 - 15 minutes. Default: - None
         :param starting_position: Where to begin consuming the stream.
         :param batch_size: The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records. Valid Range: - Minimum value of 1 - Maximum value of: - 1000 for ``DynamoEventSource`` - 10000 for ``KinesisEventSource``, ``ManagedKafkaEventSource`` and ``SelfManagedKafkaEventSource`` Default: 100
@@ -3301,7 +3301,7 @@ class DynamoEventSourceProps(StreamEventSourceProps):
         :param on_failure: An Amazon S3, Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
-        :param retry_attempts: Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source. Default: -1
+        :param retry_attempts: Maximum number of retry attempts. Set to -1 for infinite retries (until the record expires in the event source). Valid Range: -1 (infinite) or 0 to 10000 Default: -1 (infinite retries)
         :param tumbling_window: The size of the tumbling windows to group records sent to DynamoDB or Kinesis Valid Range: 0 - 15 minutes. Default: - None
 
         :exampleMetadata: infused
@@ -3536,13 +3536,13 @@ class DynamoEventSourceProps(StreamEventSourceProps):
 
     @builtins.property
     def retry_attempts(self) -> typing.Optional[jsii.Number]:
-        '''Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000.
+        '''Maximum number of retry attempts.
 
-        The default value is -1, which sets the maximum number of retries to infinite.
-        When MaximumRetryAttempts is infinite, Lambda retries failed records until
-        the record expires in the event source.
+        Set to -1 for infinite retries (until the record expires in the event source).
 
-        :default: -1
+        Valid Range: -1 (infinite) or 0 to 10000
+
+        :default: -1 (infinite retries)
         '''
         result = self._values.get("retry_attempts")
         return typing.cast(typing.Optional[jsii.Number], result)
@@ -3628,7 +3628,7 @@ class KinesisConsumerEventSource(
         :param on_failure: An Amazon S3, Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
-        :param retry_attempts: Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source. Default: -1
+        :param retry_attempts: Maximum number of retry attempts. Set to -1 for infinite retries (until the record expires in the event source). Valid Range: -1 (infinite) or 0 to 10000 Default: -1 (infinite retries)
         :param tumbling_window: The size of the tumbling windows to group records sent to DynamoDB or Kinesis Valid Range: 0 - 15 minutes. Default: - None
         :param starting_position: Where to begin consuming the stream.
         :param batch_size: The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records. Valid Range: - Minimum value of 1 - Maximum value of: - 1000 for ``DynamoEventSource`` - 10000 for ``KinesisEventSource``, ``ManagedKafkaEventSource`` and ``SelfManagedKafkaEventSource`` Default: 100
@@ -3745,7 +3745,7 @@ class KinesisEventSource(
         :param on_failure: An Amazon S3, Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
-        :param retry_attempts: Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source. Default: -1
+        :param retry_attempts: Maximum number of retry attempts. Set to -1 for infinite retries (until the record expires in the event source). Valid Range: -1 (infinite) or 0 to 10000 Default: -1 (infinite retries)
         :param tumbling_window: The size of the tumbling windows to group records sent to DynamoDB or Kinesis Valid Range: 0 - 15 minutes. Default: - None
         :param starting_position: Where to begin consuming the stream.
         :param batch_size: The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records. Valid Range: - Minimum value of 1 - Maximum value of: - 1000 for ``DynamoEventSource`` - 10000 for ``KinesisEventSource``, ``ManagedKafkaEventSource`` and ``SelfManagedKafkaEventSource`` Default: 100
@@ -3863,7 +3863,7 @@ class KinesisEventSourceProps(StreamEventSourceProps):
         :param on_failure: An Amazon S3, Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
-        :param retry_attempts: Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source. Default: -1
+        :param retry_attempts: Maximum number of retry attempts. Set to -1 for infinite retries (until the record expires in the event source). Valid Range: -1 (infinite) or 0 to 10000 Default: -1 (infinite retries)
         :param tumbling_window: The size of the tumbling windows to group records sent to DynamoDB or Kinesis Valid Range: 0 - 15 minutes. Default: - None
         :param starting_position_timestamp: The time from which to start reading, in Unix time seconds. Default: - no timestamp
 
@@ -4094,13 +4094,13 @@ class KinesisEventSourceProps(StreamEventSourceProps):
 
     @builtins.property
     def retry_attempts(self) -> typing.Optional[jsii.Number]:
-        '''Maximum number of retry attempts Valid Range: * Minimum value of 0 * Maximum value of 10000.
+        '''Maximum number of retry attempts.
 
-        The default value is -1, which sets the maximum number of retries to infinite.
-        When MaximumRetryAttempts is infinite, Lambda retries failed records until
-        the record expires in the event source.
+        Set to -1 for infinite retries (until the record expires in the event source).
 
-        :default: -1
+        Valid Range: -1 (infinite) or 0 to 10000
+
+        :default: -1 (infinite retries)
         '''
         result = self._values.get("retry_attempts")
         return typing.cast(typing.Optional[jsii.Number], result)

aws_cdk/aws_lex/__init__.py

@@ -919,7 +919,7 @@ class CfnBot(
             bedrock_guardrail_identifier: typing.Optional[builtins.str] = None,
             bedrock_guardrail_version: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''The guardrail configuration in the Bedrock model specification details.
+            '''The details on the Bedrock guardrail configuration.
 
             :param bedrock_guardrail_identifier: The unique guardrail id for the Bedrock guardrail configuration.
             :param bedrock_guardrail_version: The guardrail version for the Bedrock guardrail configuration.
@@ -2746,11 +2746,11 @@ class CfnBot(
             kendra_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnBot.QnAKendraConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             opensearch_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnBot.OpensearchConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Contains details about the configuration of the data source used for the AMAZON.QnAIntent.
+            '''Contains details about the configuration of the knowledge store used for the ``AMAZON.QnAIntent`` . You must have already created the knowledge store and indexed the documents within it.
 
-            :param bedrock_knowledge_store_configuration: Contains details about the configuration of a Amazon Bedrock knowledge base.
-            :param kendra_configuration: Contains details about the configuration of the Amazon Kendra index used for the AMAZON.QnAIntent.
-            :param opensearch_configuration: Contains details about the configuration of the Amazon OpenSearch Service database used for the AMAZON.QnAIntent.
+            :param bedrock_knowledge_store_configuration: Contains details about the configuration of the Amazon Bedrock knowledge base used for the ``AMAZON.QnAIntent`` . To set up a knowledge base, follow the steps at `Building a knowledge base <https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html>`_ .
+            :param kendra_configuration: Contains details about the configuration of the Amazon Kendra index used for the ``AMAZON.QnAIntent`` . To create a Amazon Kendra index, follow the steps at `Creating an index <https://docs.aws.amazon.com/kendra/latest/dg/create-index.html>`_ .
+            :param opensearch_configuration: Contains details about the configuration of the Amazon OpenSearch Service database used for the ``AMAZON.QnAIntent`` . To create a domain, follow the steps at `Creating and managing Amazon OpenSearch Service domains <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/createupdatedomains.html>`_ .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-datasourceconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -2806,7 +2806,7 @@ class CfnBot(
         def bedrock_knowledge_store_configuration(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnBot.BedrockKnowledgeStoreConfigurationProperty"]]:
-            '''Contains details about the configuration of a Amazon Bedrock knowledge base.
+            '''Contains details about the configuration of the Amazon Bedrock knowledge base used for the ``AMAZON.QnAIntent`` . To set up a knowledge base, follow the steps at `Building a knowledge base <https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html>`_ .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-datasourceconfiguration.html#cfn-lex-bot-datasourceconfiguration-bedrockknowledgestoreconfiguration
             '''
@@ -2817,7 +2817,7 @@ class CfnBot(
         def kendra_configuration(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnBot.QnAKendraConfigurationProperty"]]:
-            '''Contains details about the configuration of the Amazon Kendra index used for the AMAZON.QnAIntent.
+            '''Contains details about the configuration of the Amazon Kendra index used for the ``AMAZON.QnAIntent`` . To create a Amazon Kendra index, follow the steps at `Creating an index <https://docs.aws.amazon.com/kendra/latest/dg/create-index.html>`_ .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-datasourceconfiguration.html#cfn-lex-bot-datasourceconfiguration-kendraconfiguration
             '''
@@ -2828,7 +2828,7 @@ class CfnBot(
         def opensearch_configuration(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnBot.OpensearchConfigurationProperty"]]:
-            '''Contains details about the configuration of the Amazon OpenSearch Service database used for the AMAZON.QnAIntent.
+            '''Contains details about the configuration of the Amazon OpenSearch Service database used for the ``AMAZON.QnAIntent`` . To create a domain, follow the steps at `Creating and managing Amazon OpenSearch Service domains <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/createupdatedomains.html>`_ .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-datasourceconfiguration.html#cfn-lex-bot-datasourceconfiguration-opensearchconfiguration
             '''
@@ -6232,12 +6232,12 @@ class CfnBot(
             include_fields: typing.Optional[typing.Sequence[builtins.str]] = None,
             index_name: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''Contains details about the configuration of the Amazon OpenSearch Service database used for the AMAZON.QnAIntent.
+            '''Contains details about the configuration of the Amazon OpenSearch Service database used for the ``AMAZON.QnAIntent`` .
 
             :param domain_endpoint: The endpoint of the Amazon OpenSearch Service domain.
             :param exact_response: Specifies whether to return an exact response or to return an answer generated by the model using the fields you specify from the database.
             :param exact_response_fields: Contains the names of the fields used for an exact response to the user.
-            :param include_fields: List of fields to include.
+            :param include_fields: Contains a list of fields from the Amazon OpenSearch Service that the model can use to generate the answer to the query.
             :param index_name: The name of the Amazon OpenSearch Service index.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-opensearchconfiguration.html
@@ -6312,7 +6312,7 @@ class CfnBot(
 
         @builtins.property
         def include_fields(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''List of fields to include.
+            '''Contains a list of fields from the Amazon OpenSearch Service that the model can use to generate the answer to the query.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-opensearchconfiguration.html#cfn-lex-bot-opensearchconfiguration-includefields
             '''
@@ -7222,10 +7222,10 @@ class CfnBot(
             bedrock_model_configuration: typing.Union[_IResolvable_da3f097b, typing.Union["CfnBot.BedrockModelSpecificationProperty", typing.Dict[builtins.str, typing.Any]]],
             data_source_configuration: typing.Union[_IResolvable_da3f097b, typing.Union["CfnBot.DataSourceConfigurationProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''Details about the the configuration of the built-in Amazon.QnAIntent.
+            '''Details about the the configuration of the built-in ``Amazon.QnAIntent`` .
 
             :param bedrock_model_configuration: Contains information about the Amazon Bedrock model used to interpret the prompt used in descriptive bot building.
-            :param data_source_configuration: Contains details about the configuration of the data source used for the AMAZON.QnAIntent.
+            :param data_source_configuration: Contains details about the configuration of the data source used for the ``AMAZON.QnAIntent`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-qnaintentconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -7302,7 +7302,7 @@ class CfnBot(
         def data_source_configuration(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnBot.DataSourceConfigurationProperty"]:
-            '''Contains details about the configuration of the data source used for the AMAZON.QnAIntent.
+            '''Contains details about the configuration of the data source used for the ``AMAZON.QnAIntent`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-qnaintentconfiguration.html#cfn-lex-bot-qnaintentconfiguration-datasourceconfiguration
             '''
@@ -7340,12 +7340,12 @@ class CfnBot(
             query_filter_string_enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
             query_filter_string: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''Contains details about the configuration of the Amazon Kendra index used for the AMAZON.QnAIntent.
+            '''Contains details about the configuration of the Amazon Kendra index used for the ``AMAZON.QnAIntent`` .
 
-            :param exact_response: Specifies whether to return an exact response from the Amazon Kendra index or to let the Amazon Bedrock model you select generate a response based on the results.
+            :param exact_response: Specifies whether to return an exact response from the Amazon Kendra index or to let the Amazon Bedrock model you select generate a response based on the results. To use this feature, you must first add FAQ questions to your index by following the steps at `Adding frequently asked questions (FAQs) to an index <https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html>`_ .
             :param kendra_index: The ARN of the Amazon Kendra index to use.
             :param query_filter_string_enabled: Specifies whether to enable an Amazon Kendra filter string or not.
-            :param query_filter_string: Contains the Amazon Kendra filter string to use if enabled.
+            :param query_filter_string: Contains the Amazon Kendra filter string to use if enabled. For more information on the Amazon Kendra search filter JSON format, see `Using document attributes to filter search results <https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering>`_ .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-qnakendraconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -7383,6 +7383,8 @@ class CfnBot(
         def exact_response(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
             '''Specifies whether to return an exact response from the Amazon Kendra index or to let the Amazon Bedrock model you select generate a response based on the results.
 
+            To use this feature, you must first add FAQ questions to your index by following the steps at `Adding frequently asked questions (FAQs) to an index <https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html>`_ .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-qnakendraconfiguration.html#cfn-lex-bot-qnakendraconfiguration-exactresponse
             '''
             result = self._values.get("exact_response")
@@ -7415,6 +7417,8 @@ class CfnBot(
         def query_filter_string(self) -> typing.Optional[builtins.str]:
             '''Contains the Amazon Kendra filter string to use if enabled.
 
+            For more information on the Amazon Kendra search filter JSON format, see `Using document attributes to filter search results <https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering>`_ .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-qnakendraconfiguration.html#cfn-lex-bot-qnakendraconfiguration-queryfilterstring
             '''
             result = self._values.get("query_filter_string")

aws_cdk/aws_logs/__init__.py

@@ -159,6 +159,24 @@ logs.SubscriptionFilter(self, "Subscription",
 )
 ```
 
+When you use `FirehoseDestination`, you can choose the method used to
+distribute log data to the destination by setting the `distribution` property.
+
+```python
+import aws_cdk.aws_logs_destinations as destinations
+import aws_cdk.aws_kinesisfirehose as firehose
+
+# delivery_stream: firehose.IDeliveryStream
+# log_group: logs.LogGroup
+
+
+logs.SubscriptionFilter(self, "Subscription",
+    log_group=log_group,
+    destination=destinations.FirehoseDestination(delivery_stream),
+    filter_pattern=logs.FilterPattern.all_events()
+)
+```
+
 ## Metric Filters
 
 CloudWatch Logs can extract and emit metrics based on a textual log stream.