aws-cdk-lib 2.171.1__py3-none-any.whl → 2.173.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

Files changed (78) hide show
  1. aws_cdk/__init__.py +528 -161
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.171.1.jsii.tgz → aws-cdk-lib@2.173.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_amazonmq/__init__.py +40 -40
  5. aws_cdk/aws_apigateway/__init__.py +1357 -120
  6. aws_cdk/aws_applicationautoscaling/__init__.py +141 -66
  7. aws_cdk/aws_appsync/__init__.py +163 -139
  8. aws_cdk/aws_autoscaling/__init__.py +96 -30
  9. aws_cdk/aws_bedrock/__init__.py +80 -44
  10. aws_cdk/aws_chatbot/__init__.py +803 -2
  11. aws_cdk/aws_cleanrooms/__init__.py +4 -6
  12. aws_cdk/aws_cloudformation/__init__.py +240 -159
  13. aws_cdk/aws_cloudfront/__init__.py +15 -7
  14. aws_cdk/aws_cloudtrail/__init__.py +802 -13
  15. aws_cdk/aws_cloudwatch/__init__.py +51 -14
  16. aws_cdk/aws_codebuild/__init__.py +39 -0
  17. aws_cdk/aws_codepipeline/__init__.py +4 -4
  18. aws_cdk/aws_cognito/__init__.py +1032 -43
  19. aws_cdk/aws_config/__init__.py +13 -10
  20. aws_cdk/aws_connect/__init__.py +454 -23
  21. aws_cdk/aws_connectcampaignsv2/__init__.py +187 -176
  22. aws_cdk/aws_customerprofiles/__init__.py +3148 -0
  23. aws_cdk/aws_docdb/__init__.py +128 -0
  24. aws_cdk/aws_dynamodb/__init__.py +256 -0
  25. aws_cdk/aws_ec2/__init__.py +976 -27
  26. aws_cdk/aws_ecs/__init__.py +37 -20
  27. aws_cdk/aws_eks/__init__.py +771 -0
  28. aws_cdk/aws_elasticache/__init__.py +22 -22
  29. aws_cdk/aws_elasticloadbalancingv2/__init__.py +441 -177
  30. aws_cdk/aws_events/__init__.py +550 -30
  31. aws_cdk/aws_fsx/__init__.py +134 -10
  32. aws_cdk/aws_imagebuilder/__init__.py +8 -8
  33. aws_cdk/aws_invoicing/__init__.py +651 -0
  34. aws_cdk/aws_iot/__init__.py +70 -26
  35. aws_cdk/aws_iotfleetwise/__init__.py +1033 -382
  36. aws_cdk/aws_iotsitewise/__init__.py +158 -0
  37. aws_cdk/aws_ivs/__init__.py +43 -31
  38. aws_cdk/aws_kendra/__init__.py +4 -0
  39. aws_cdk/aws_lakeformation/__init__.py +2 -1
  40. aws_cdk/aws_lambda/__init__.py +272 -164
  41. aws_cdk/aws_lambda_event_sources/__init__.py +2 -1
  42. aws_cdk/aws_lambda_nodejs/__init__.py +11 -11
  43. aws_cdk/aws_logs/__init__.py +532 -0
  44. aws_cdk/aws_m2/__init__.py +289 -0
  45. aws_cdk/aws_mediaconnect/__init__.py +24 -14
  46. aws_cdk/aws_medialive/__init__.py +2359 -5
  47. aws_cdk/aws_mediapackage/__init__.py +3 -9
  48. aws_cdk/aws_mediapackagev2/__init__.py +19 -17
  49. aws_cdk/aws_memorydb/__init__.py +664 -4
  50. aws_cdk/aws_mwaa/__init__.py +6 -6
  51. aws_cdk/aws_opensearchserverless/__init__.py +249 -1
  52. aws_cdk/aws_pipes/__init__.py +14 -30
  53. aws_cdk/aws_qbusiness/__init__.py +2021 -67
  54. aws_cdk/aws_quicksight/__init__.py +8270 -10
  55. aws_cdk/aws_rbin/__init__.py +53 -34
  56. aws_cdk/aws_rds/__init__.py +170 -8
  57. aws_cdk/aws_resourcegroups/__init__.py +362 -4
  58. aws_cdk/aws_route53/__init__.py +1177 -10
  59. aws_cdk/aws_route53_targets/__init__.py +297 -91
  60. aws_cdk/aws_route53resolver/__init__.py +19 -8
  61. aws_cdk/aws_s3/__init__.py +4 -4
  62. aws_cdk/aws_s3express/__init__.py +421 -9
  63. aws_cdk/aws_sagemaker/__init__.py +905 -119
  64. aws_cdk/aws_secretsmanager/__init__.py +20 -6
  65. aws_cdk/aws_securityhub/__init__.py +64 -32
  66. aws_cdk/aws_servicediscovery/__init__.py +43 -0
  67. aws_cdk/aws_ses/__init__.py +188 -41
  68. aws_cdk/aws_stepfunctions_tasks/__init__.py +190 -35
  69. aws_cdk/aws_synthetics/__init__.py +7 -5
  70. aws_cdk/aws_vpclattice/__init__.py +1479 -122
  71. aws_cdk/aws_wisdom/__init__.py +8509 -1502
  72. aws_cdk/aws_workspacesweb/__init__.py +1081 -0
  73. {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/METADATA +1 -1
  74. {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/RECORD +78 -77
  75. {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/LICENSE +0 -0
  76. {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/NOTICE +0 -0
  77. {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/WHEEL +0 -0
  78. {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/top_level.txt +0 -0
@@ -4135,7 +4135,7 @@ class CfnEventInvokeConfig(
4135
4135
  :param id: Construct identifier for this resource (unique in its scope).
4136
4136
  :param function_name: The name of the Lambda function. *Minimum* : ``1`` *Maximum* : ``64`` *Pattern* : ``([a-zA-Z0-9-_]+)``
4137
4137
  :param qualifier: The identifier of a version or alias. - *Version* - A version number. - *Alias* - An alias name. - *Latest* - To specify the unpublished version, use ``$LATEST`` .
4138
- :param destination_config: A destination for events after they have been sent to a function for processing. **Destinations** - *Function* - The Amazon Resource Name (ARN) of a Lambda function. - *Queue* - The ARN of a standard SQS queue. - *Topic* - The ARN of a standard SNS topic. - *Event Bus* - The ARN of an Amazon EventBridge event bus.
4138
+ :param destination_config: A destination for events after they have been sent to a function for processing. **Destinations** - *Function* - The Amazon Resource Name (ARN) of a Lambda function. - *Queue* - The ARN of a standard SQS queue. - *Bucket* - The ARN of an Amazon S3 bucket. - *Topic* - The ARN of a standard SNS topic. - *Event Bus* - The ARN of an Amazon EventBridge event bus. .. epigraph:: S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.
4139
4139
  :param maximum_event_age_in_seconds: The maximum age of a request that Lambda sends to a function for processing.
4140
4140
  :param maximum_retry_attempts: The maximum number of times to retry when the function returns an error.
4141
4141
  '''
@@ -4345,7 +4345,7 @@ class CfnEventInvokeConfig(
4345
4345
  def __init__(self, *, destination: builtins.str) -> None:
4346
4346
  '''A destination for events that failed processing.
4347
4347
 
4348
- :param destination: The Amazon Resource Name (ARN) of the destination resource. To retain records of `asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, Lambda function, or Amazon EventBridge event bus as the destination. To retain records of failed invocations from `Kinesis and DynamoDB event sources <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#event-source-mapping-destinations>`_ , you can configure an Amazon SNS topic or Amazon SQS queue as the destination. To retain records of failed invocations from `self-managed Kafka <https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination>`_ or `Amazon MSK <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.
4348
+ :param destination: The Amazon Resource Name (ARN) of the destination resource. To retain records of unsuccessful `asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3 bucket, Lambda function, or Amazon EventBridge event bus as the destination. To retain records of failed invocations from `Kinesis <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html>`_ , `DynamoDB <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html>`_ , `self-managed Kafka <https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination>`_ or `Amazon MSK <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.
4349
4349
 
4350
4350
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-onfailure.html
4351
4351
  :exampleMetadata: fixture=_generated
@@ -4371,11 +4371,9 @@ class CfnEventInvokeConfig(
4371
4371
  def destination(self) -> builtins.str:
4372
4372
  '''The Amazon Resource Name (ARN) of the destination resource.
4373
4373
 
4374
- To retain records of `asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, Lambda function, or Amazon EventBridge event bus as the destination.
4374
+ To retain records of unsuccessful `asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3 bucket, Lambda function, or Amazon EventBridge event bus as the destination.
4375
4375
 
4376
- To retain records of failed invocations from `Kinesis and DynamoDB event sources <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#event-source-mapping-destinations>`_ , you can configure an Amazon SNS topic or Amazon SQS queue as the destination.
4377
-
4378
- To retain records of failed invocations from `self-managed Kafka <https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination>`_ or `Amazon MSK <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.
4376
+ To retain records of failed invocations from `Kinesis <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html>`_ , `DynamoDB <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html>`_ , `self-managed Kafka <https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination>`_ or `Amazon MSK <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.
4379
4377
 
4380
4378
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-onfailure.html#cfn-lambda-eventinvokeconfig-onfailure-destination
4381
4379
  '''
@@ -4403,6 +4401,8 @@ class CfnEventInvokeConfig(
4403
4401
  def __init__(self, *, destination: builtins.str) -> None:
4404
4402
  '''A destination for events that were processed successfully.
4405
4403
 
4404
+ To retain records of successful `asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, Lambda function, or Amazon EventBridge event bus as the destination.
4405
+
4406
4406
  :param destination: The Amazon Resource Name (ARN) of the destination resource.
4407
4407
 
4408
4408
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-onsuccess.html
@@ -4472,7 +4472,7 @@ class CfnEventInvokeConfigProps:
4472
4472
 
4473
4473
  :param function_name: The name of the Lambda function. *Minimum* : ``1`` *Maximum* : ``64`` *Pattern* : ``([a-zA-Z0-9-_]+)``
4474
4474
  :param qualifier: The identifier of a version or alias. - *Version* - A version number. - *Alias* - An alias name. - *Latest* - To specify the unpublished version, use ``$LATEST`` .
4475
- :param destination_config: A destination for events after they have been sent to a function for processing. **Destinations** - *Function* - The Amazon Resource Name (ARN) of a Lambda function. - *Queue* - The ARN of a standard SQS queue. - *Topic* - The ARN of a standard SNS topic. - *Event Bus* - The ARN of an Amazon EventBridge event bus.
4475
+ :param destination_config: A destination for events after they have been sent to a function for processing. **Destinations** - *Function* - The Amazon Resource Name (ARN) of a Lambda function. - *Queue* - The ARN of a standard SQS queue. - *Bucket* - The ARN of an Amazon S3 bucket. - *Topic* - The ARN of a standard SNS topic. - *Event Bus* - The ARN of an Amazon EventBridge event bus. .. epigraph:: S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.
4476
4476
  :param maximum_event_age_in_seconds: The maximum age of a request that Lambda sends to a function for processing.
4477
4477
  :param maximum_retry_attempts: The maximum number of times to retry when the function returns an error.
4478
4478
 
@@ -4559,9 +4559,14 @@ class CfnEventInvokeConfigProps:
4559
4559
  **Destinations** - *Function* - The Amazon Resource Name (ARN) of a Lambda function.
4560
4560
 
4561
4561
  - *Queue* - The ARN of a standard SQS queue.
4562
+ - *Bucket* - The ARN of an Amazon S3 bucket.
4562
4563
  - *Topic* - The ARN of a standard SNS topic.
4563
4564
  - *Event Bus* - The ARN of an Amazon EventBridge event bus.
4564
4565
 
4566
+ .. epigraph::
4567
+
4568
+ S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.
4569
+
4565
4570
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventinvokeconfig.html#cfn-lambda-eventinvokeconfig-destinationconfig
4566
4571
  '''
4567
4572
  result = self._values.get("destination_config")
@@ -4729,33 +4734,33 @@ class CfnEventSourceMapping(
4729
4734
  '''
4730
4735
  :param scope: Scope in which this resource is defined.
4731
4736
  :param id: Construct identifier for this resource (unique in its scope).
4732
- :param function_name: The name of the Lambda function.
4733
- :param amazon_managed_kafka_event_source_config: Specific configuration settings for an MSK event source.
4734
- :param batch_size: The maximum number of items to retrieve in a single batch.
4735
- :param bisect_batch_on_function_error: (Streams) If the function returns an error, split the batch in two and retry.
4736
- :param destination_config: A configuration object that specifies the destination of an event after Lambda processes it.
4737
- :param document_db_event_source_config: Document db event source config.
4738
- :param enabled: Disables the event source mapping to pause polling and invocation.
4739
- :param event_source_arn: The Amazon Resource Name (ARN) of the event source.
4740
- :param filter_criteria: The filter criteria to control event filtering.
4741
- :param function_response_types: (Streams) A list of response types supported by the function.
4742
- :param kms_key_arn: The Amazon Resource Name (ARN) of the KMS key.
4743
- :param maximum_batching_window_in_seconds: (Streams) The maximum amount of time to gather records before invoking the function, in seconds.
4744
- :param maximum_record_age_in_seconds: (Streams) The maximum age of a record that Lambda sends to a function for processing.
4745
- :param maximum_retry_attempts: (Streams) The maximum number of times to retry when the function returns an error.
4746
- :param metrics_config: Metrics config for Event Source Mapping Metrics.
4747
- :param parallelization_factor: (Streams) The number of batches to process from each shard concurrently.
4748
- :param provisioned_poller_config: ProvisionedPollerConfig.
4749
- :param queues: (ActiveMQ) A list of ActiveMQ queues.
4750
- :param scaling_config: The scaling configuration for the event source.
4751
- :param self_managed_event_source: The configuration used by AWS Lambda to access a self-managed event source.
4752
- :param self_managed_kafka_event_source_config: Specific configuration settings for a Self-Managed Apache Kafka event source.
4753
- :param source_access_configurations: A list of SourceAccessConfiguration.
4754
- :param starting_position: The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB Streams sources.
4755
- :param starting_position_timestamp: With StartingPosition set to AT_TIMESTAMP, the time from which to start reading, in Unix time seconds.
4756
- :param tags: A list of tags to apply to event source mapping resource.
4757
- :param topics: (Kafka) A list of Kafka topics.
4758
- :param tumbling_window_in_seconds: (Streams) Tumbling window (non-overlapping time window) duration to perform aggregations.
4737
+ :param function_name: The name or ARN of the Lambda function. **Name formats** - *Function name* – ``MyFunction`` . - *Function ARN* – ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction`` . - *Version or Alias ARN* – ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD`` . - *Partial ARN* – ``123456789012:function:MyFunction`` . The length constraint applies only to the full ARN. If you specify only the function name, it's limited to 64 characters in length.
4738
+ :param amazon_managed_kafka_event_source_config: Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.
4739
+ :param batch_size: The maximum number of records in each batch that Lambda pulls from your stream or queue and sends to your function. Lambda passes all of the records in the batch to the function in a single call, up to the payload limit for synchronous invocation (6 MB). - *Amazon Kinesis* – Default 100. Max 10,000. - *Amazon DynamoDB Streams* – Default 100. Max 10,000. - *Amazon Simple Queue Service* – Default 10. For standard queues the max is 10,000. For FIFO queues the max is 10. - *Amazon Managed Streaming for Apache Kafka* – Default 100. Max 10,000. - *Self-managed Apache Kafka* – Default 100. Max 10,000. - *Amazon MQ (ActiveMQ and RabbitMQ)* – Default 100. Max 10,000. - *DocumentDB* – Default 100. Max 10,000.
4740
+ :param bisect_batch_on_function_error: (Kinesis and DynamoDB Streams only) If the function returns an error, split the batch in two and retry. The default value is false.
4741
+ :param destination_config: (Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka event sources only) A configuration object that specifies the destination of an event after Lambda processes it.
4742
+ :param document_db_event_source_config: Specific configuration settings for a DocumentDB event source.
4743
+ :param enabled: When true, the event source mapping is active. When false, Lambda pauses polling and invocation. Default: True
4744
+ :param event_source_arn: The Amazon Resource Name (ARN) of the event source. - *Amazon Kinesis* – The ARN of the data stream or a stream consumer. - *Amazon DynamoDB Streams* – The ARN of the stream. - *Amazon Simple Queue Service* – The ARN of the queue. - *Amazon Managed Streaming for Apache Kafka* – The ARN of the cluster or the ARN of the VPC connection (for `cross-account event source mappings <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#msk-multi-vpc>`_ ). - *Amazon MQ* – The ARN of the broker. - *Amazon DocumentDB* – The ARN of the DocumentDB change stream.
4745
+ :param filter_criteria: An object that defines the filter criteria that determine whether Lambda should process an event. For more information, see `Lambda event filtering <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html>`_ .
4746
+ :param function_response_types: (Kinesis, DynamoDB Streams, and SQS) A list of current response type enums applied to the event source mapping. Valid Values: ``ReportBatchItemFailures``
4747
+ :param kms_key_arn: The ARN of the AWS Key Management Service ( AWS KMS ) customer managed key that Lambda uses to encrypt your function's `filter criteria <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics>`_ .
4748
+ :param maximum_batching_window_in_seconds: The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function. *Default ( Kinesis , DynamoDB , Amazon SQS event sources)* : 0 *Default ( Amazon MSK , Kafka, Amazon MQ , Amazon DocumentDB event sources)* : 500 ms *Related setting:* For Amazon SQS event sources, when you set ``BatchSize`` to a value greater than 10, you must set ``MaximumBatchingWindowInSeconds`` to at least 1.
4749
+ :param maximum_record_age_in_seconds: (Kinesis and DynamoDB Streams only) Discard records older than the specified age. The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records. .. epigraph:: The minimum valid value for maximum record age is 60s. Although values less than 60 and greater than -1 fall within the parameter's absolute range, they are not allowed
4750
+ :param maximum_retry_attempts: (Kinesis and DynamoDB Streams only) Discard records after the specified number of retries. 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.
4751
+ :param metrics_config: The metrics configuration for your event source. For more information, see `Event source mapping metrics <https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics>`_ .
4752
+ :param parallelization_factor: (Kinesis and DynamoDB Streams only) The number of batches to process concurrently from each shard. The default value is 1.
4753
+ :param provisioned_poller_config: (Amazon MSK and self-managed Apache Kafka only) The provisioned mode configuration for the event source. For more information, see `provisioned mode <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode>`_ .
4754
+ :param queues: (Amazon MQ) The name of the Amazon MQ broker destination queue to consume.
4755
+ :param scaling_config: (Amazon SQS only) The scaling configuration for the event source. For more information, see `Configuring maximum concurrency for Amazon SQS event sources <https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency>`_ .
4756
+ :param self_managed_event_source: The self-managed Apache Kafka cluster for your event source.
4757
+ :param self_managed_kafka_event_source_config: Specific configuration settings for a self-managed Apache Kafka event source.
4758
+ :param source_access_configurations: An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.
4759
+ :param starting_position: The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB. - *LATEST* - Read only new records. - *TRIM_HORIZON* - Process all available records. - *AT_TIMESTAMP* - Specify a time from which to start reading records.
4760
+ :param starting_position_timestamp: With ``StartingPosition`` set to ``AT_TIMESTAMP`` , the time from which to start reading, in Unix time seconds. ``StartingPositionTimestamp`` cannot be in the future.
4761
+ :param tags: A list of tags to add to the event source mapping. .. epigraph:: You must have the ``lambda:TagResource`` , ``lambda:UntagResource`` , and ``lambda:ListTags`` permissions for your `IAM principal <https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html>`_ to manage the AWS CloudFormation stack. If you don't have these permissions, there might be unexpected behavior with stack-level tags propagating to the resource during resource creation and update.
4762
+ :param topics: The name of the Kafka topic.
4763
+ :param tumbling_window_in_seconds: (Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources. A value of 0 seconds indicates no tumbling window.
4759
4764
  '''
4760
4765
  if __debug__:
4761
4766
  type_hints = typing.get_type_hints(_typecheckingstub__2fc9432254acf5a7dbe3c68dcedbda61de1f0e804a81d20ae79e04857b83d419)
@@ -4826,7 +4831,7 @@ class CfnEventSourceMapping(
4826
4831
  @builtins.property
4827
4832
  @jsii.member(jsii_name="attrEventSourceMappingArn")
4828
4833
  def attr_event_source_mapping_arn(self) -> builtins.str:
4829
- '''The Amazon Resource Name (ARN) of the event source mapping resource.
4834
+ '''The Amazon Resource Name (ARN) of the event source mapping.
4830
4835
 
4831
4836
  :cloudformationAttribute: EventSourceMappingArn
4832
4837
  '''
@@ -4835,7 +4840,7 @@ class CfnEventSourceMapping(
4835
4840
  @builtins.property
4836
4841
  @jsii.member(jsii_name="attrId")
4837
4842
  def attr_id(self) -> builtins.str:
4838
- '''Event Source Mapping Identifier UUID.
4843
+ '''The event source mapping's ID.
4839
4844
 
4840
4845
  :cloudformationAttribute: Id
4841
4846
  '''
@@ -4855,7 +4860,7 @@ class CfnEventSourceMapping(
4855
4860
  @builtins.property
4856
4861
  @jsii.member(jsii_name="functionName")
4857
4862
  def function_name(self) -> builtins.str:
4858
- '''The name of the Lambda function.'''
4863
+ '''The name or ARN of the Lambda function.'''
4859
4864
  return typing.cast(builtins.str, jsii.get(self, "functionName"))
4860
4865
 
4861
4866
  @function_name.setter
@@ -4870,7 +4875,7 @@ class CfnEventSourceMapping(
4870
4875
  def amazon_managed_kafka_event_source_config(
4871
4876
  self,
4872
4877
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.AmazonManagedKafkaEventSourceConfigProperty"]]:
4873
- '''Specific configuration settings for an MSK event source.'''
4878
+ '''Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.'''
4874
4879
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.AmazonManagedKafkaEventSourceConfigProperty"]], jsii.get(self, "amazonManagedKafkaEventSourceConfig"))
4875
4880
 
4876
4881
  @amazon_managed_kafka_event_source_config.setter
@@ -4886,7 +4891,7 @@ class CfnEventSourceMapping(
4886
4891
  @builtins.property
4887
4892
  @jsii.member(jsii_name="batchSize")
4888
4893
  def batch_size(self) -> typing.Optional[jsii.Number]:
4889
- '''The maximum number of items to retrieve in a single batch.'''
4894
+ '''The maximum number of records in each batch that Lambda pulls from your stream or queue and sends to your function.'''
4890
4895
  return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "batchSize"))
4891
4896
 
4892
4897
  @batch_size.setter
@@ -4901,7 +4906,7 @@ class CfnEventSourceMapping(
4901
4906
  def bisect_batch_on_function_error(
4902
4907
  self,
4903
4908
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
4904
- '''(Streams) If the function returns an error, split the batch in two and retry.'''
4909
+ '''(Kinesis and DynamoDB Streams only) If the function returns an error, split the batch in two and retry.'''
4905
4910
  return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "bisectBatchOnFunctionError"))
4906
4911
 
4907
4912
  @bisect_batch_on_function_error.setter
@@ -4919,7 +4924,7 @@ class CfnEventSourceMapping(
4919
4924
  def destination_config(
4920
4925
  self,
4921
4926
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.DestinationConfigProperty"]]:
4922
- '''A configuration object that specifies the destination of an event after Lambda processes it.'''
4927
+ '''(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka event sources only) A configuration object that specifies the destination of an event after Lambda processes it.'''
4923
4928
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.DestinationConfigProperty"]], jsii.get(self, "destinationConfig"))
4924
4929
 
4925
4930
  @destination_config.setter
@@ -4937,7 +4942,7 @@ class CfnEventSourceMapping(
4937
4942
  def document_db_event_source_config(
4938
4943
  self,
4939
4944
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.DocumentDBEventSourceConfigProperty"]]:
4940
- '''Document db event source config.'''
4945
+ '''Specific configuration settings for a DocumentDB event source.'''
4941
4946
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.DocumentDBEventSourceConfigProperty"]], jsii.get(self, "documentDbEventSourceConfig"))
4942
4947
 
4943
4948
  @document_db_event_source_config.setter
@@ -4955,7 +4960,10 @@ class CfnEventSourceMapping(
4955
4960
  def enabled(
4956
4961
  self,
4957
4962
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
4958
- '''Disables the event source mapping to pause polling and invocation.'''
4963
+ '''When true, the event source mapping is active.
4964
+
4965
+ When false, Lambda pauses polling and invocation.
4966
+ '''
4959
4967
  return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "enabled"))
4960
4968
 
4961
4969
  @enabled.setter
@@ -4986,7 +4994,7 @@ class CfnEventSourceMapping(
4986
4994
  def filter_criteria(
4987
4995
  self,
4988
4996
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.FilterCriteriaProperty"]]:
4989
- '''The filter criteria to control event filtering.'''
4997
+ '''An object that defines the filter criteria that determine whether Lambda should process an event.'''
4990
4998
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.FilterCriteriaProperty"]], jsii.get(self, "filterCriteria"))
4991
4999
 
4992
5000
  @filter_criteria.setter
@@ -5002,7 +5010,7 @@ class CfnEventSourceMapping(
5002
5010
  @builtins.property
5003
5011
  @jsii.member(jsii_name="functionResponseTypes")
5004
5012
  def function_response_types(self) -> typing.Optional[typing.List[builtins.str]]:
5005
- '''(Streams) A list of response types supported by the function.'''
5013
+ '''(Kinesis, DynamoDB Streams, and SQS) A list of current response type enums applied to the event source mapping.'''
5006
5014
  return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "functionResponseTypes"))
5007
5015
 
5008
5016
  @function_response_types.setter
@@ -5018,7 +5026,7 @@ class CfnEventSourceMapping(
5018
5026
  @builtins.property
5019
5027
  @jsii.member(jsii_name="kmsKeyArn")
5020
5028
  def kms_key_arn(self) -> typing.Optional[builtins.str]:
5021
- '''The Amazon Resource Name (ARN) of the KMS key.'''
5029
+ '''The ARN of the AWS Key Management Service ( AWS KMS ) customer managed key that Lambda uses to encrypt your function's `filter criteria <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics>`_ .'''
5022
5030
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "kmsKeyArn"))
5023
5031
 
5024
5032
  @kms_key_arn.setter
@@ -5031,7 +5039,7 @@ class CfnEventSourceMapping(
5031
5039
  @builtins.property
5032
5040
  @jsii.member(jsii_name="maximumBatchingWindowInSeconds")
5033
5041
  def maximum_batching_window_in_seconds(self) -> typing.Optional[jsii.Number]:
5034
- '''(Streams) The maximum amount of time to gather records before invoking the function, in seconds.'''
5042
+ '''The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function.'''
5035
5043
  return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "maximumBatchingWindowInSeconds"))
5036
5044
 
5037
5045
  @maximum_batching_window_in_seconds.setter
@@ -5047,7 +5055,7 @@ class CfnEventSourceMapping(
5047
5055
  @builtins.property
5048
5056
  @jsii.member(jsii_name="maximumRecordAgeInSeconds")
5049
5057
  def maximum_record_age_in_seconds(self) -> typing.Optional[jsii.Number]:
5050
- '''(Streams) The maximum age of a record that Lambda sends to a function for processing.'''
5058
+ '''(Kinesis and DynamoDB Streams only) Discard records older than the specified age.'''
5051
5059
  return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "maximumRecordAgeInSeconds"))
5052
5060
 
5053
5061
  @maximum_record_age_in_seconds.setter
@@ -5063,7 +5071,7 @@ class CfnEventSourceMapping(
5063
5071
  @builtins.property
5064
5072
  @jsii.member(jsii_name="maximumRetryAttempts")
5065
5073
  def maximum_retry_attempts(self) -> typing.Optional[jsii.Number]:
5066
- '''(Streams) The maximum number of times to retry when the function returns an error.'''
5074
+ '''(Kinesis and DynamoDB Streams only) Discard records after the specified number of retries.'''
5067
5075
  return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "maximumRetryAttempts"))
5068
5076
 
5069
5077
  @maximum_retry_attempts.setter
@@ -5078,7 +5086,7 @@ class CfnEventSourceMapping(
5078
5086
  def metrics_config(
5079
5087
  self,
5080
5088
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.MetricsConfigProperty"]]:
5081
- '''Metrics config for Event Source Mapping Metrics.'''
5089
+ '''The metrics configuration for your event source.'''
5082
5090
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.MetricsConfigProperty"]], jsii.get(self, "metricsConfig"))
5083
5091
 
5084
5092
  @metrics_config.setter
@@ -5094,7 +5102,7 @@ class CfnEventSourceMapping(
5094
5102
  @builtins.property
5095
5103
  @jsii.member(jsii_name="parallelizationFactor")
5096
5104
  def parallelization_factor(self) -> typing.Optional[jsii.Number]:
5097
- '''(Streams) The number of batches to process from each shard concurrently.'''
5105
+ '''(Kinesis and DynamoDB Streams only) The number of batches to process concurrently from each shard.'''
5098
5106
  return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "parallelizationFactor"))
5099
5107
 
5100
5108
  @parallelization_factor.setter
@@ -5109,7 +5117,7 @@ class CfnEventSourceMapping(
5109
5117
  def provisioned_poller_config(
5110
5118
  self,
5111
5119
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.ProvisionedPollerConfigProperty"]]:
5112
- '''ProvisionedPollerConfig.'''
5120
+ '''(Amazon MSK and self-managed Apache Kafka only) The provisioned mode configuration for the event source.'''
5113
5121
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.ProvisionedPollerConfigProperty"]], jsii.get(self, "provisionedPollerConfig"))
5114
5122
 
5115
5123
  @provisioned_poller_config.setter
@@ -5125,7 +5133,7 @@ class CfnEventSourceMapping(
5125
5133
  @builtins.property
5126
5134
  @jsii.member(jsii_name="queues")
5127
5135
  def queues(self) -> typing.Optional[typing.List[builtins.str]]:
5128
- '''(ActiveMQ) A list of ActiveMQ queues.'''
5136
+ '''(Amazon MQ) The name of the Amazon MQ broker destination queue to consume.'''
5129
5137
  return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "queues"))
5130
5138
 
5131
5139
  @queues.setter
@@ -5140,7 +5148,7 @@ class CfnEventSourceMapping(
5140
5148
  def scaling_config(
5141
5149
  self,
5142
5150
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.ScalingConfigProperty"]]:
5143
- '''The scaling configuration for the event source.'''
5151
+ '''(Amazon SQS only) The scaling configuration for the event source.'''
5144
5152
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.ScalingConfigProperty"]], jsii.get(self, "scalingConfig"))
5145
5153
 
5146
5154
  @scaling_config.setter
@@ -5158,7 +5166,7 @@ class CfnEventSourceMapping(
5158
5166
  def self_managed_event_source(
5159
5167
  self,
5160
5168
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.SelfManagedEventSourceProperty"]]:
5161
- '''The configuration used by AWS Lambda to access a self-managed event source.'''
5169
+ '''The self-managed Apache Kafka cluster for your event source.'''
5162
5170
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.SelfManagedEventSourceProperty"]], jsii.get(self, "selfManagedEventSource"))
5163
5171
 
5164
5172
  @self_managed_event_source.setter
@@ -5176,7 +5184,7 @@ class CfnEventSourceMapping(
5176
5184
  def self_managed_kafka_event_source_config(
5177
5185
  self,
5178
5186
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.SelfManagedKafkaEventSourceConfigProperty"]]:
5179
- '''Specific configuration settings for a Self-Managed Apache Kafka event source.'''
5187
+ '''Specific configuration settings for a self-managed Apache Kafka event source.'''
5180
5188
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.SelfManagedKafkaEventSourceConfigProperty"]], jsii.get(self, "selfManagedKafkaEventSourceConfig"))
5181
5189
 
5182
5190
  @self_managed_kafka_event_source_config.setter
@@ -5194,7 +5202,7 @@ class CfnEventSourceMapping(
5194
5202
  def source_access_configurations(
5195
5203
  self,
5196
5204
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.SourceAccessConfigurationProperty"]]]]:
5197
- '''A list of SourceAccessConfiguration.'''
5205
+ '''An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.'''
5198
5206
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.SourceAccessConfigurationProperty"]]]], jsii.get(self, "sourceAccessConfigurations"))
5199
5207
 
5200
5208
  @source_access_configurations.setter
@@ -5210,7 +5218,10 @@ class CfnEventSourceMapping(
5210
5218
  @builtins.property
5211
5219
  @jsii.member(jsii_name="startingPosition")
5212
5220
  def starting_position(self) -> typing.Optional[builtins.str]:
5213
- '''The position in a stream from which to start reading.'''
5221
+ '''The position in a stream from which to start reading.
5222
+
5223
+ Required for Amazon Kinesis and Amazon DynamoDB.
5224
+ '''
5214
5225
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "startingPosition"))
5215
5226
 
5216
5227
  @starting_position.setter
@@ -5223,7 +5234,7 @@ class CfnEventSourceMapping(
5223
5234
  @builtins.property
5224
5235
  @jsii.member(jsii_name="startingPositionTimestamp")
5225
5236
  def starting_position_timestamp(self) -> typing.Optional[jsii.Number]:
5226
- '''With StartingPosition set to AT_TIMESTAMP, the time from which to start reading, in Unix time seconds.'''
5237
+ '''With ``StartingPosition`` set to ``AT_TIMESTAMP`` , the time from which to start reading, in Unix time seconds.'''
5227
5238
  return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "startingPositionTimestamp"))
5228
5239
 
5229
5240
  @starting_position_timestamp.setter
@@ -5236,7 +5247,7 @@ class CfnEventSourceMapping(
5236
5247
  @builtins.property
5237
5248
  @jsii.member(jsii_name="tags")
5238
5249
  def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
5239
- '''A list of tags to apply to event source mapping resource.'''
5250
+ '''A list of tags to add to the event source mapping.'''
5240
5251
  return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
5241
5252
 
5242
5253
  @tags.setter
@@ -5249,7 +5260,7 @@ class CfnEventSourceMapping(
5249
5260
  @builtins.property
5250
5261
  @jsii.member(jsii_name="topics")
5251
5262
  def topics(self) -> typing.Optional[typing.List[builtins.str]]:
5252
- '''(Kafka) A list of Kafka topics.'''
5263
+ '''The name of the Kafka topic.'''
5253
5264
  return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "topics"))
5254
5265
 
5255
5266
  @topics.setter
@@ -5262,7 +5273,7 @@ class CfnEventSourceMapping(
5262
5273
  @builtins.property
5263
5274
  @jsii.member(jsii_name="tumblingWindowInSeconds")
5264
5275
  def tumbling_window_in_seconds(self) -> typing.Optional[jsii.Number]:
5265
- '''(Streams) Tumbling window (non-overlapping time window) duration to perform aggregations.'''
5276
+ '''(Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources.'''
5266
5277
  return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "tumblingWindowInSeconds"))
5267
5278
 
5268
5279
  @tumbling_window_in_seconds.setter
@@ -5283,9 +5294,9 @@ class CfnEventSourceMapping(
5283
5294
  *,
5284
5295
  consumer_group_id: typing.Optional[builtins.str] = None,
5285
5296
  ) -> None:
5286
- '''Specific configuration settings for an MSK event source.
5297
+ '''Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.
5287
5298
 
5288
- :param consumer_group_id: The identifier for the Kafka Consumer Group to join.
5299
+ :param consumer_group_id: The identifier for the Kafka consumer group to join. The consumer group ID must be unique among all your Kafka event sources. After creating a Kafka event source mapping with the consumer group ID specified, you cannot update this value. For more information, see `Customizable consumer group ID <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-consumer-group-id>`_ .
5289
5300
 
5290
5301
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-amazonmanagedkafkaeventsourceconfig.html
5291
5302
  :exampleMetadata: fixture=_generated
@@ -5309,7 +5320,9 @@ class CfnEventSourceMapping(
5309
5320
 
5310
5321
  @builtins.property
5311
5322
  def consumer_group_id(self) -> typing.Optional[builtins.str]:
5312
- '''The identifier for the Kafka Consumer Group to join.
5323
+ '''The identifier for the Kafka consumer group to join.
5324
+
5325
+ The consumer group ID must be unique among all your Kafka event sources. After creating a Kafka event source mapping with the consumer group ID specified, you cannot update this value. For more information, see `Customizable consumer group ID <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-consumer-group-id>`_ .
5313
5326
 
5314
5327
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-amazonmanagedkafkaeventsourceconfig.html#cfn-lambda-eventsourcemapping-amazonmanagedkafkaeventsourceconfig-consumergroupid
5315
5328
  '''
@@ -5340,7 +5353,7 @@ class CfnEventSourceMapping(
5340
5353
  ) -> None:
5341
5354
  '''A configuration object that specifies the destination of an event after Lambda processes it.
5342
5355
 
5343
- :param on_failure: A destination for records of invocations that failed processing.
5356
+ :param on_failure: The destination configuration for failed invocations.
5344
5357
 
5345
5358
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-destinationconfig.html
5346
5359
  :exampleMetadata: fixture=_generated
@@ -5368,7 +5381,7 @@ class CfnEventSourceMapping(
5368
5381
  def on_failure(
5369
5382
  self,
5370
5383
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.OnFailureProperty"]]:
5371
- '''A destination for records of invocations that failed processing.
5384
+ '''The destination configuration for failed invocations.
5372
5385
 
5373
5386
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-destinationconfig.html#cfn-lambda-eventsourcemapping-destinationconfig-onfailure
5374
5387
  '''
@@ -5403,11 +5416,11 @@ class CfnEventSourceMapping(
5403
5416
  database_name: typing.Optional[builtins.str] = None,
5404
5417
  full_document: typing.Optional[builtins.str] = None,
5405
5418
  ) -> None:
5406
- '''Document db event source config.
5419
+ '''Specific configuration settings for a DocumentDB event source.
5407
5420
 
5408
- :param collection_name: The collection name to connect to.
5409
- :param database_name: The database name to connect to.
5410
- :param full_document: Include full document in change stream response. The default option will only send the changes made to documents to Lambda. If you want the complete document sent to Lambda, set this to UpdateLookup.
5421
+ :param collection_name: The name of the collection to consume within the database. If you do not specify a collection, Lambda consumes all collections.
5422
+ :param database_name: The name of the database to consume within the DocumentDB cluster.
5423
+ :param full_document: Determines what DocumentDB sends to your event stream during document update operations. If set to UpdateLookup, DocumentDB sends a delta describing the changes, along with a copy of the entire document. Otherwise, DocumentDB sends only a partial document that contains the changes.
5411
5424
 
5412
5425
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-documentdbeventsourceconfig.html
5413
5426
  :exampleMetadata: fixture=_generated
@@ -5439,7 +5452,9 @@ class CfnEventSourceMapping(
5439
5452
 
5440
5453
  @builtins.property
5441
5454
  def collection_name(self) -> typing.Optional[builtins.str]:
5442
- '''The collection name to connect to.
5455
+ '''The name of the collection to consume within the database.
5456
+
5457
+ If you do not specify a collection, Lambda consumes all collections.
5443
5458
 
5444
5459
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-documentdbeventsourceconfig.html#cfn-lambda-eventsourcemapping-documentdbeventsourceconfig-collectionname
5445
5460
  '''
@@ -5448,7 +5463,7 @@ class CfnEventSourceMapping(
5448
5463
 
5449
5464
  @builtins.property
5450
5465
  def database_name(self) -> typing.Optional[builtins.str]:
5451
- '''The database name to connect to.
5466
+ '''The name of the database to consume within the DocumentDB cluster.
5452
5467
 
5453
5468
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-documentdbeventsourceconfig.html#cfn-lambda-eventsourcemapping-documentdbeventsourceconfig-databasename
5454
5469
  '''
@@ -5457,9 +5472,9 @@ class CfnEventSourceMapping(
5457
5472
 
5458
5473
  @builtins.property
5459
5474
  def full_document(self) -> typing.Optional[builtins.str]:
5460
- '''Include full document in change stream response.
5475
+ '''Determines what DocumentDB sends to your event stream during document update operations.
5461
5476
 
5462
- The default option will only send the changes made to documents to Lambda. If you want the complete document sent to Lambda, set this to UpdateLookup.
5477
+ If set to UpdateLookup, DocumentDB sends a delta describing the changes, along with a copy of the entire document. Otherwise, DocumentDB sends only a partial document that contains the changes.
5463
5478
 
5464
5479
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-documentdbeventsourceconfig.html#cfn-lambda-eventsourcemapping-documentdbeventsourceconfig-fulldocument
5465
5480
  '''
@@ -5488,9 +5503,9 @@ class CfnEventSourceMapping(
5488
5503
  *,
5489
5504
  kafka_bootstrap_servers: typing.Optional[typing.Sequence[builtins.str]] = None,
5490
5505
  ) -> None:
5491
- '''The endpoints used by AWS Lambda to access a self-managed event source.
5506
+ '''The list of bootstrap servers for your Kafka brokers in the following format: ``"KafkaBootstrapServers": ["abc.xyz.com:xxxx","abc2.xyz.com:xxxx"]`` .
5492
5507
 
5493
- :param kafka_bootstrap_servers: A list of Kafka server endpoints.
5508
+ :param kafka_bootstrap_servers: The list of bootstrap servers for your Kafka brokers in the following format: ``"KafkaBootstrapServers": ["abc.xyz.com:xxxx","abc2.xyz.com:xxxx"]`` .
5494
5509
 
5495
5510
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-endpoints.html
5496
5511
  :exampleMetadata: fixture=_generated
@@ -5514,7 +5529,7 @@ class CfnEventSourceMapping(
5514
5529
 
5515
5530
  @builtins.property
5516
5531
  def kafka_bootstrap_servers(self) -> typing.Optional[typing.List[builtins.str]]:
5517
- '''A list of Kafka server endpoints.
5532
+ '''The list of bootstrap servers for your Kafka brokers in the following format: ``"KafkaBootstrapServers": ["abc.xyz.com:xxxx","abc2.xyz.com:xxxx"]`` .
5518
5533
 
5519
5534
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-endpoints.html#cfn-lambda-eventsourcemapping-endpoints-kafkabootstrapservers
5520
5535
  '''
@@ -5543,9 +5558,9 @@ class CfnEventSourceMapping(
5543
5558
  *,
5544
5559
  filters: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnEventSourceMapping.FilterProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
5545
5560
  ) -> None:
5546
- '''The filter criteria to control event filtering.
5561
+ '''An object that contains the filters for an event source.
5547
5562
 
5548
- :param filters: List of filters of this FilterCriteria.
5563
+ :param filters: A list of filters.
5549
5564
 
5550
5565
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html
5551
5566
  :exampleMetadata: fixture=_generated
@@ -5573,7 +5588,7 @@ class CfnEventSourceMapping(
5573
5588
  def filters(
5574
5589
  self,
5575
5590
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.FilterProperty"]]]]:
5576
- '''List of filters of this FilterCriteria.
5591
+ '''A list of filters.
5577
5592
 
5578
5593
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filtercriteria.html#cfn-lambda-eventsourcemapping-filtercriteria-filters
5579
5594
  '''
@@ -5598,9 +5613,9 @@ class CfnEventSourceMapping(
5598
5613
  )
5599
5614
  class FilterProperty:
5600
5615
  def __init__(self, *, pattern: typing.Optional[builtins.str] = None) -> None:
5601
- '''The filter object that defines parameters for ESM filtering.
5616
+ '''A structure within a ``FilterCriteria`` object that defines an event filtering pattern.
5602
5617
 
5603
- :param pattern: The filter pattern that defines which events should be passed for invocations.
5618
+ :param pattern: A filter pattern. For more information on the syntax of a filter pattern, see `Filter rule syntax <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-syntax>`_ .
5604
5619
 
5605
5620
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filter.html
5606
5621
  :exampleMetadata: fixture=_generated
@@ -5624,7 +5639,9 @@ class CfnEventSourceMapping(
5624
5639
 
5625
5640
  @builtins.property
5626
5641
  def pattern(self) -> typing.Optional[builtins.str]:
5627
- '''The filter pattern that defines which events should be passed for invocations.
5642
+ '''A filter pattern.
5643
+
5644
+ For more information on the syntax of a filter pattern, see `Filter rule syntax <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-syntax>`_ .
5628
5645
 
5629
5646
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-filter.html#cfn-lambda-eventsourcemapping-filter-pattern
5630
5647
  '''
@@ -5653,9 +5670,11 @@ class CfnEventSourceMapping(
5653
5670
  *,
5654
5671
  metrics: typing.Optional[typing.Sequence[builtins.str]] = None,
5655
5672
  ) -> None:
5656
- '''Metrics config for Event Source Mapping Metrics.
5673
+ '''The metrics configuration for your event source.
5657
5674
 
5658
- :param metrics: Metric groups to enable.
5675
+ Use this configuration object to define which metrics you want your event source mapping to produce.
5676
+
5677
+ :param metrics: The metrics you want your event source mapping to produce. Include ``EventCount`` to receive event source mapping metrics related to the number of events processed by your event source mapping. For more information about these metrics, see `Event source mapping metrics <https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics>`_ .
5659
5678
 
5660
5679
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig.html
5661
5680
  :exampleMetadata: fixture=_generated
@@ -5679,7 +5698,9 @@ class CfnEventSourceMapping(
5679
5698
 
5680
5699
  @builtins.property
5681
5700
  def metrics(self) -> typing.Optional[typing.List[builtins.str]]:
5682
- '''Metric groups to enable.
5701
+ '''The metrics you want your event source mapping to produce.
5702
+
5703
+ Include ``EventCount`` to receive event source mapping metrics related to the number of events processed by your event source mapping. For more information about these metrics, see `Event source mapping metrics <https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics>`_ .
5683
5704
 
5684
5705
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-metricsconfig.html#cfn-lambda-eventsourcemapping-metricsconfig-metrics
5685
5706
  '''
@@ -5708,9 +5729,9 @@ class CfnEventSourceMapping(
5708
5729
  *,
5709
5730
  destination: typing.Optional[builtins.str] = None,
5710
5731
  ) -> None:
5711
- '''A destination for records of invocations that failed processing.
5732
+ '''A destination for events that failed processing.
5712
5733
 
5713
- :param destination: The Amazon Resource Name (ARN) of the destination resource.
5734
+ :param destination: The Amazon Resource Name (ARN) of the destination resource. To retain records of unsuccessful `asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3 bucket, Lambda function, or Amazon EventBridge event bus as the destination. To retain records of failed invocations from `Kinesis <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html>`_ , `DynamoDB <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html>`_ , `self-managed Kafka <https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination>`_ or `Amazon MSK <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.
5714
5735
 
5715
5736
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-onfailure.html
5716
5737
  :exampleMetadata: fixture=_generated
@@ -5736,6 +5757,10 @@ class CfnEventSourceMapping(
5736
5757
  def destination(self) -> typing.Optional[builtins.str]:
5737
5758
  '''The Amazon Resource Name (ARN) of the destination resource.
5738
5759
 
5760
+ To retain records of unsuccessful `asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3 bucket, Lambda function, or Amazon EventBridge event bus as the destination.
5761
+
5762
+ To retain records of failed invocations from `Kinesis <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html>`_ , `DynamoDB <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html>`_ , `self-managed Kafka <https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination>`_ or `Amazon MSK <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination>`_ , you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.
5763
+
5739
5764
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-onfailure.html#cfn-lambda-eventsourcemapping-onfailure-destination
5740
5765
  '''
5741
5766
  result = self._values.get("destination")
@@ -5767,10 +5792,10 @@ class CfnEventSourceMapping(
5767
5792
  maximum_pollers: typing.Optional[jsii.Number] = None,
5768
5793
  minimum_pollers: typing.Optional[jsii.Number] = None,
5769
5794
  ) -> None:
5770
- '''ProvisionedPollerConfig.
5795
+ '''The `provisioned mode <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode>`_ configuration for the event source. Use provisioned mode to customize the minimum and maximum number of event pollers for your event source.
5771
5796
 
5772
- :param maximum_pollers: Maximum poller count.
5773
- :param minimum_pollers: Minimum poller count.
5797
+ :param maximum_pollers: The maximum number of event pollers this event source can scale up to.
5798
+ :param minimum_pollers: The minimum number of event pollers this event source can scale down to.
5774
5799
 
5775
5800
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig.html
5776
5801
  :exampleMetadata: fixture=_generated
@@ -5798,7 +5823,7 @@ class CfnEventSourceMapping(
5798
5823
 
5799
5824
  @builtins.property
5800
5825
  def maximum_pollers(self) -> typing.Optional[jsii.Number]:
5801
- '''Maximum poller count.
5826
+ '''The maximum number of event pollers this event source can scale up to.
5802
5827
 
5803
5828
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig.html#cfn-lambda-eventsourcemapping-provisionedpollerconfig-maximumpollers
5804
5829
  '''
@@ -5807,7 +5832,7 @@ class CfnEventSourceMapping(
5807
5832
 
5808
5833
  @builtins.property
5809
5834
  def minimum_pollers(self) -> typing.Optional[jsii.Number]:
5810
- '''Minimum poller count.
5835
+ '''The minimum number of event pollers this event source can scale down to.
5811
5836
 
5812
5837
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-provisionedpollerconfig.html#cfn-lambda-eventsourcemapping-provisionedpollerconfig-minimumpollers
5813
5838
  '''
@@ -5836,9 +5861,11 @@ class CfnEventSourceMapping(
5836
5861
  *,
5837
5862
  maximum_concurrency: typing.Optional[jsii.Number] = None,
5838
5863
  ) -> None:
5839
- '''The scaling configuration for the event source.
5864
+ '''(Amazon SQS only) The scaling configuration for the event source.
5840
5865
 
5841
- :param maximum_concurrency: The maximum number of concurrent functions that an event source can invoke.
5866
+ To remove the configuration, pass an empty value.
5867
+
5868
+ :param maximum_concurrency: Limits the number of concurrent instances that the Amazon SQS event source can invoke.
5842
5869
 
5843
5870
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-scalingconfig.html
5844
5871
  :exampleMetadata: fixture=_generated
@@ -5862,7 +5889,7 @@ class CfnEventSourceMapping(
5862
5889
 
5863
5890
  @builtins.property
5864
5891
  def maximum_concurrency(self) -> typing.Optional[jsii.Number]:
5865
- '''The maximum number of concurrent functions that an event source can invoke.
5892
+ '''Limits the number of concurrent instances that the Amazon SQS event source can invoke.
5866
5893
 
5867
5894
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-scalingconfig.html#cfn-lambda-eventsourcemapping-scalingconfig-maximumconcurrency
5868
5895
  '''
@@ -5891,9 +5918,9 @@ class CfnEventSourceMapping(
5891
5918
  *,
5892
5919
  endpoints: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnEventSourceMapping.EndpointsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
5893
5920
  ) -> None:
5894
- '''The configuration used by AWS Lambda to access a self-managed event source.
5921
+ '''The self-managed Apache Kafka cluster for your event source.
5895
5922
 
5896
- :param endpoints: The endpoints used by AWS Lambda to access a self-managed event source.
5923
+ :param endpoints: The list of bootstrap servers for your Kafka brokers in the following format: ``"KafkaBootstrapServers": ["abc.xyz.com:xxxx","abc2.xyz.com:xxxx"]`` .
5897
5924
 
5898
5925
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-selfmanagedeventsource.html
5899
5926
  :exampleMetadata: fixture=_generated
@@ -5921,7 +5948,7 @@ class CfnEventSourceMapping(
5921
5948
  def endpoints(
5922
5949
  self,
5923
5950
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventSourceMapping.EndpointsProperty"]]:
5924
- '''The endpoints used by AWS Lambda to access a self-managed event source.
5951
+ '''The list of bootstrap servers for your Kafka brokers in the following format: ``"KafkaBootstrapServers": ["abc.xyz.com:xxxx","abc2.xyz.com:xxxx"]`` .
5925
5952
 
5926
5953
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-selfmanagedeventsource.html#cfn-lambda-eventsourcemapping-selfmanagedeventsource-endpoints
5927
5954
  '''
@@ -5950,9 +5977,9 @@ class CfnEventSourceMapping(
5950
5977
  *,
5951
5978
  consumer_group_id: typing.Optional[builtins.str] = None,
5952
5979
  ) -> None:
5953
- '''Specific configuration settings for a Self-Managed Apache Kafka event source.
5980
+ '''Specific configuration settings for a self-managed Apache Kafka event source.
5954
5981
 
5955
- :param consumer_group_id: The identifier for the Kafka Consumer Group to join.
5982
+ :param consumer_group_id: The identifier for the Kafka consumer group to join. The consumer group ID must be unique among all your Kafka event sources. After creating a Kafka event source mapping with the consumer group ID specified, you cannot update this value. For more information, see `Customizable consumer group ID <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-consumer-group-id>`_ .
5956
5983
 
5957
5984
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-selfmanagedkafkaeventsourceconfig.html
5958
5985
  :exampleMetadata: fixture=_generated
@@ -5976,7 +6003,9 @@ class CfnEventSourceMapping(
5976
6003
 
5977
6004
  @builtins.property
5978
6005
  def consumer_group_id(self) -> typing.Optional[builtins.str]:
5979
- '''The identifier for the Kafka Consumer Group to join.
6006
+ '''The identifier for the Kafka consumer group to join.
6007
+
6008
+ The consumer group ID must be unique among all your Kafka event sources. After creating a Kafka event source mapping with the consumer group ID specified, you cannot update this value. For more information, see `Customizable consumer group ID <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-consumer-group-id>`_ .
5980
6009
 
5981
6010
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-selfmanagedkafkaeventsourceconfig.html#cfn-lambda-eventsourcemapping-selfmanagedkafkaeventsourceconfig-consumergroupid
5982
6011
  '''
@@ -6006,10 +6035,10 @@ class CfnEventSourceMapping(
6006
6035
  type: typing.Optional[builtins.str] = None,
6007
6036
  uri: typing.Optional[builtins.str] = None,
6008
6037
  ) -> None:
6009
- '''The configuration used by AWS Lambda to access event source.
6038
+ '''An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.
6010
6039
 
6011
- :param type: The type of source access configuration.
6012
- :param uri: The URI for the source access configuration resource.
6040
+ :param type: The type of authentication protocol, VPC components, or virtual host for your event source. For example: ``"Type":"SASL_SCRAM_512_AUTH"`` . - ``BASIC_AUTH`` – (Amazon MQ) The AWS Secrets Manager secret that stores your broker credentials. - ``BASIC_AUTH`` – (Self-managed Apache Kafka) The Secrets Manager ARN of your secret key used for SASL/PLAIN authentication of your Apache Kafka brokers. - ``VPC_SUBNET`` – (Self-managed Apache Kafka) The subnets associated with your VPC. Lambda connects to these subnets to fetch data from your self-managed Apache Kafka cluster. - ``VPC_SECURITY_GROUP`` – (Self-managed Apache Kafka) The VPC security group used to manage access to your self-managed Apache Kafka brokers. - ``SASL_SCRAM_256_AUTH`` – (Self-managed Apache Kafka) The Secrets Manager ARN of your secret key used for SASL SCRAM-256 authentication of your self-managed Apache Kafka brokers. - ``SASL_SCRAM_512_AUTH`` – (Amazon MSK, Self-managed Apache Kafka) The Secrets Manager ARN of your secret key used for SASL SCRAM-512 authentication of your self-managed Apache Kafka brokers. - ``VIRTUAL_HOST`` –- (RabbitMQ) The name of the virtual host in your RabbitMQ broker. Lambda uses this RabbitMQ host as the event source. This property cannot be specified in an UpdateEventSourceMapping API call. - ``CLIENT_CERTIFICATE_TLS_AUTH`` – (Amazon MSK, self-managed Apache Kafka) The Secrets Manager ARN of your secret key containing the certificate chain (X.509 PEM), private key (PKCS#8 PEM), and private key password (optional) used for mutual TLS authentication of your MSK/Apache Kafka brokers. - ``SERVER_ROOT_CA_CERTIFICATE`` – (Self-managed Apache Kafka) The Secrets Manager ARN of your secret key containing the root CA certificate (X.509 PEM) used for TLS encryption of your Apache Kafka brokers.
6041
+ :param uri: The value for your chosen configuration in ``Type`` . For example: ``"URI": "arn:aws:secretsmanager:us-east-1:01234567890:secret:MyBrokerSecretName"`` .
6013
6042
 
6014
6043
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-sourceaccessconfiguration.html
6015
6044
  :exampleMetadata: fixture=_generated
@@ -6037,7 +6066,17 @@ class CfnEventSourceMapping(
6037
6066
 
6038
6067
  @builtins.property
6039
6068
  def type(self) -> typing.Optional[builtins.str]:
6040
- '''The type of source access configuration.
6069
+ '''The type of authentication protocol, VPC components, or virtual host for your event source. For example: ``"Type":"SASL_SCRAM_512_AUTH"`` .
6070
+
6071
+ - ``BASIC_AUTH`` – (Amazon MQ) The AWS Secrets Manager secret that stores your broker credentials.
6072
+ - ``BASIC_AUTH`` – (Self-managed Apache Kafka) The Secrets Manager ARN of your secret key used for SASL/PLAIN authentication of your Apache Kafka brokers.
6073
+ - ``VPC_SUBNET`` – (Self-managed Apache Kafka) The subnets associated with your VPC. Lambda connects to these subnets to fetch data from your self-managed Apache Kafka cluster.
6074
+ - ``VPC_SECURITY_GROUP`` – (Self-managed Apache Kafka) The VPC security group used to manage access to your self-managed Apache Kafka brokers.
6075
+ - ``SASL_SCRAM_256_AUTH`` – (Self-managed Apache Kafka) The Secrets Manager ARN of your secret key used for SASL SCRAM-256 authentication of your self-managed Apache Kafka brokers.
6076
+ - ``SASL_SCRAM_512_AUTH`` – (Amazon MSK, Self-managed Apache Kafka) The Secrets Manager ARN of your secret key used for SASL SCRAM-512 authentication of your self-managed Apache Kafka brokers.
6077
+ - ``VIRTUAL_HOST`` –- (RabbitMQ) The name of the virtual host in your RabbitMQ broker. Lambda uses this RabbitMQ host as the event source. This property cannot be specified in an UpdateEventSourceMapping API call.
6078
+ - ``CLIENT_CERTIFICATE_TLS_AUTH`` – (Amazon MSK, self-managed Apache Kafka) The Secrets Manager ARN of your secret key containing the certificate chain (X.509 PEM), private key (PKCS#8 PEM), and private key password (optional) used for mutual TLS authentication of your MSK/Apache Kafka brokers.
6079
+ - ``SERVER_ROOT_CA_CERTIFICATE`` – (Self-managed Apache Kafka) The Secrets Manager ARN of your secret key containing the root CA certificate (X.509 PEM) used for TLS encryption of your Apache Kafka brokers.
6041
6080
 
6042
6081
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-sourceaccessconfiguration.html#cfn-lambda-eventsourcemapping-sourceaccessconfiguration-type
6043
6082
  '''
@@ -6046,7 +6085,9 @@ class CfnEventSourceMapping(
6046
6085
 
6047
6086
  @builtins.property
6048
6087
  def uri(self) -> typing.Optional[builtins.str]:
6049
- '''The URI for the source access configuration resource.
6088
+ '''The value for your chosen configuration in ``Type`` .
6089
+
6090
+ For example: ``"URI": "arn:aws:secretsmanager:us-east-1:01234567890:secret:MyBrokerSecretName"`` .
6050
6091
 
6051
6092
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventsourcemapping-sourceaccessconfiguration.html#cfn-lambda-eventsourcemapping-sourceaccessconfiguration-uri
6052
6093
  '''
@@ -6132,33 +6173,33 @@ class CfnEventSourceMappingProps:
6132
6173
  ) -> None:
6133
6174
  '''Properties for defining a ``CfnEventSourceMapping``.
6134
6175
 
6135
- :param function_name: The name of the Lambda function.
6136
- :param amazon_managed_kafka_event_source_config: Specific configuration settings for an MSK event source.
6137
- :param batch_size: The maximum number of items to retrieve in a single batch.
6138
- :param bisect_batch_on_function_error: (Streams) If the function returns an error, split the batch in two and retry.
6139
- :param destination_config: A configuration object that specifies the destination of an event after Lambda processes it.
6140
- :param document_db_event_source_config: Document db event source config.
6141
- :param enabled: Disables the event source mapping to pause polling and invocation.
6142
- :param event_source_arn: The Amazon Resource Name (ARN) of the event source.
6143
- :param filter_criteria: The filter criteria to control event filtering.
6144
- :param function_response_types: (Streams) A list of response types supported by the function.
6145
- :param kms_key_arn: The Amazon Resource Name (ARN) of the KMS key.
6146
- :param maximum_batching_window_in_seconds: (Streams) The maximum amount of time to gather records before invoking the function, in seconds.
6147
- :param maximum_record_age_in_seconds: (Streams) The maximum age of a record that Lambda sends to a function for processing.
6148
- :param maximum_retry_attempts: (Streams) The maximum number of times to retry when the function returns an error.
6149
- :param metrics_config: Metrics config for Event Source Mapping Metrics.
6150
- :param parallelization_factor: (Streams) The number of batches to process from each shard concurrently.
6151
- :param provisioned_poller_config: ProvisionedPollerConfig.
6152
- :param queues: (ActiveMQ) A list of ActiveMQ queues.
6153
- :param scaling_config: The scaling configuration for the event source.
6154
- :param self_managed_event_source: The configuration used by AWS Lambda to access a self-managed event source.
6155
- :param self_managed_kafka_event_source_config: Specific configuration settings for a Self-Managed Apache Kafka event source.
6156
- :param source_access_configurations: A list of SourceAccessConfiguration.
6157
- :param starting_position: The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB Streams sources.
6158
- :param starting_position_timestamp: With StartingPosition set to AT_TIMESTAMP, the time from which to start reading, in Unix time seconds.
6159
- :param tags: A list of tags to apply to event source mapping resource.
6160
- :param topics: (Kafka) A list of Kafka topics.
6161
- :param tumbling_window_in_seconds: (Streams) Tumbling window (non-overlapping time window) duration to perform aggregations.
6176
+ :param function_name: The name or ARN of the Lambda function. **Name formats** - *Function name* – ``MyFunction`` . - *Function ARN* – ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction`` . - *Version or Alias ARN* – ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD`` . - *Partial ARN* – ``123456789012:function:MyFunction`` . The length constraint applies only to the full ARN. If you specify only the function name, it's limited to 64 characters in length.
6177
+ :param amazon_managed_kafka_event_source_config: Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.
6178
+ :param batch_size: The maximum number of records in each batch that Lambda pulls from your stream or queue and sends to your function. Lambda passes all of the records in the batch to the function in a single call, up to the payload limit for synchronous invocation (6 MB). - *Amazon Kinesis* – Default 100. Max 10,000. - *Amazon DynamoDB Streams* – Default 100. Max 10,000. - *Amazon Simple Queue Service* – Default 10. For standard queues the max is 10,000. For FIFO queues the max is 10. - *Amazon Managed Streaming for Apache Kafka* – Default 100. Max 10,000. - *Self-managed Apache Kafka* – Default 100. Max 10,000. - *Amazon MQ (ActiveMQ and RabbitMQ)* – Default 100. Max 10,000. - *DocumentDB* – Default 100. Max 10,000.
6179
+ :param bisect_batch_on_function_error: (Kinesis and DynamoDB Streams only) If the function returns an error, split the batch in two and retry. The default value is false.
6180
+ :param destination_config: (Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka event sources only) A configuration object that specifies the destination of an event after Lambda processes it.
6181
+ :param document_db_event_source_config: Specific configuration settings for a DocumentDB event source.
6182
+ :param enabled: When true, the event source mapping is active. When false, Lambda pauses polling and invocation. Default: True
6183
+ :param event_source_arn: The Amazon Resource Name (ARN) of the event source. - *Amazon Kinesis* – The ARN of the data stream or a stream consumer. - *Amazon DynamoDB Streams* – The ARN of the stream. - *Amazon Simple Queue Service* – The ARN of the queue. - *Amazon Managed Streaming for Apache Kafka* – The ARN of the cluster or the ARN of the VPC connection (for `cross-account event source mappings <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#msk-multi-vpc>`_ ). - *Amazon MQ* – The ARN of the broker. - *Amazon DocumentDB* – The ARN of the DocumentDB change stream.
6184
+ :param filter_criteria: An object that defines the filter criteria that determine whether Lambda should process an event. For more information, see `Lambda event filtering <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html>`_ .
6185
+ :param function_response_types: (Kinesis, DynamoDB Streams, and SQS) A list of current response type enums applied to the event source mapping. Valid Values: ``ReportBatchItemFailures``
6186
+ :param kms_key_arn: The ARN of the AWS Key Management Service ( AWS KMS ) customer managed key that Lambda uses to encrypt your function's `filter criteria <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics>`_ .
6187
+ :param maximum_batching_window_in_seconds: The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function. *Default ( Kinesis , DynamoDB , Amazon SQS event sources)* : 0 *Default ( Amazon MSK , Kafka, Amazon MQ , Amazon DocumentDB event sources)* : 500 ms *Related setting:* For Amazon SQS event sources, when you set ``BatchSize`` to a value greater than 10, you must set ``MaximumBatchingWindowInSeconds`` to at least 1.
6188
+ :param maximum_record_age_in_seconds: (Kinesis and DynamoDB Streams only) Discard records older than the specified age. The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records. .. epigraph:: The minimum valid value for maximum record age is 60s. Although values less than 60 and greater than -1 fall within the parameter's absolute range, they are not allowed
6189
+ :param maximum_retry_attempts: (Kinesis and DynamoDB Streams only) Discard records after the specified number of retries. 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.
6190
+ :param metrics_config: The metrics configuration for your event source. For more information, see `Event source mapping metrics <https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics>`_ .
6191
+ :param parallelization_factor: (Kinesis and DynamoDB Streams only) The number of batches to process concurrently from each shard. The default value is 1.
6192
+ :param provisioned_poller_config: (Amazon MSK and self-managed Apache Kafka only) The provisioned mode configuration for the event source. For more information, see `provisioned mode <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode>`_ .
6193
+ :param queues: (Amazon MQ) The name of the Amazon MQ broker destination queue to consume.
6194
+ :param scaling_config: (Amazon SQS only) The scaling configuration for the event source. For more information, see `Configuring maximum concurrency for Amazon SQS event sources <https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency>`_ .
6195
+ :param self_managed_event_source: The self-managed Apache Kafka cluster for your event source.
6196
+ :param self_managed_kafka_event_source_config: Specific configuration settings for a self-managed Apache Kafka event source.
6197
+ :param source_access_configurations: An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.
6198
+ :param starting_position: The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB. - *LATEST* - Read only new records. - *TRIM_HORIZON* - Process all available records. - *AT_TIMESTAMP* - Specify a time from which to start reading records.
6199
+ :param starting_position_timestamp: With ``StartingPosition`` set to ``AT_TIMESTAMP`` , the time from which to start reading, in Unix time seconds. ``StartingPositionTimestamp`` cannot be in the future.
6200
+ :param tags: A list of tags to add to the event source mapping. .. epigraph:: You must have the ``lambda:TagResource`` , ``lambda:UntagResource`` , and ``lambda:ListTags`` permissions for your `IAM principal <https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html>`_ to manage the AWS CloudFormation stack. If you don't have these permissions, there might be unexpected behavior with stack-level tags propagating to the resource during resource creation and update.
6201
+ :param topics: The name of the Kafka topic.
6202
+ :param tumbling_window_in_seconds: (Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources. A value of 0 seconds indicates no tumbling window.
6162
6203
 
6163
6204
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html
6164
6205
  :exampleMetadata: fixture=_generated
@@ -6321,7 +6362,15 @@ class CfnEventSourceMappingProps:
6321
6362
 
6322
6363
  @builtins.property
6323
6364
  def function_name(self) -> builtins.str:
6324
- '''The name of the Lambda function.
6365
+ '''The name or ARN of the Lambda function.
6366
+
6367
+ **Name formats** - *Function name* – ``MyFunction`` .
6368
+
6369
+ - *Function ARN* – ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction`` .
6370
+ - *Version or Alias ARN* – ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD`` .
6371
+ - *Partial ARN* – ``123456789012:function:MyFunction`` .
6372
+
6373
+ The length constraint applies only to the full ARN. If you specify only the function name, it's limited to 64 characters in length.
6325
6374
 
6326
6375
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-functionname
6327
6376
  '''
@@ -6333,7 +6382,7 @@ class CfnEventSourceMappingProps:
6333
6382
  def amazon_managed_kafka_event_source_config(
6334
6383
  self,
6335
6384
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.AmazonManagedKafkaEventSourceConfigProperty]]:
6336
- '''Specific configuration settings for an MSK event source.
6385
+ '''Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.
6337
6386
 
6338
6387
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-amazonmanagedkafkaeventsourceconfig
6339
6388
  '''
@@ -6342,7 +6391,17 @@ class CfnEventSourceMappingProps:
6342
6391
 
6343
6392
  @builtins.property
6344
6393
  def batch_size(self) -> typing.Optional[jsii.Number]:
6345
- '''The maximum number of items to retrieve in a single batch.
6394
+ '''The maximum number of records in each batch that Lambda pulls from your stream or queue and sends to your function.
6395
+
6396
+ Lambda passes all of the records in the batch to the function in a single call, up to the payload limit for synchronous invocation (6 MB).
6397
+
6398
+ - *Amazon Kinesis* – Default 100. Max 10,000.
6399
+ - *Amazon DynamoDB Streams* – Default 100. Max 10,000.
6400
+ - *Amazon Simple Queue Service* – Default 10. For standard queues the max is 10,000. For FIFO queues the max is 10.
6401
+ - *Amazon Managed Streaming for Apache Kafka* – Default 100. Max 10,000.
6402
+ - *Self-managed Apache Kafka* – Default 100. Max 10,000.
6403
+ - *Amazon MQ (ActiveMQ and RabbitMQ)* – Default 100. Max 10,000.
6404
+ - *DocumentDB* – Default 100. Max 10,000.
6346
6405
 
6347
6406
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-batchsize
6348
6407
  '''
@@ -6353,7 +6412,9 @@ class CfnEventSourceMappingProps:
6353
6412
  def bisect_batch_on_function_error(
6354
6413
  self,
6355
6414
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
6356
- '''(Streams) If the function returns an error, split the batch in two and retry.
6415
+ '''(Kinesis and DynamoDB Streams only) If the function returns an error, split the batch in two and retry.
6416
+
6417
+ The default value is false.
6357
6418
 
6358
6419
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-bisectbatchonfunctionerror
6359
6420
  '''
@@ -6364,7 +6425,7 @@ class CfnEventSourceMappingProps:
6364
6425
  def destination_config(
6365
6426
  self,
6366
6427
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.DestinationConfigProperty]]:
6367
- '''A configuration object that specifies the destination of an event after Lambda processes it.
6428
+ '''(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka event sources only) A configuration object that specifies the destination of an event after Lambda processes it.
6368
6429
 
6369
6430
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-destinationconfig
6370
6431
  '''
@@ -6375,7 +6436,7 @@ class CfnEventSourceMappingProps:
6375
6436
  def document_db_event_source_config(
6376
6437
  self,
6377
6438
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.DocumentDBEventSourceConfigProperty]]:
6378
- '''Document db event source config.
6439
+ '''Specific configuration settings for a DocumentDB event source.
6379
6440
 
6380
6441
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-documentdbeventsourceconfig
6381
6442
  '''
@@ -6386,7 +6447,9 @@ class CfnEventSourceMappingProps:
6386
6447
  def enabled(
6387
6448
  self,
6388
6449
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
6389
- '''Disables the event source mapping to pause polling and invocation.
6450
+ '''When true, the event source mapping is active. When false, Lambda pauses polling and invocation.
6451
+
6452
+ Default: True
6390
6453
 
6391
6454
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled
6392
6455
  '''
@@ -6397,6 +6460,13 @@ class CfnEventSourceMappingProps:
6397
6460
  def event_source_arn(self) -> typing.Optional[builtins.str]:
6398
6461
  '''The Amazon Resource Name (ARN) of the event source.
6399
6462
 
6463
+ - *Amazon Kinesis* – The ARN of the data stream or a stream consumer.
6464
+ - *Amazon DynamoDB Streams* – The ARN of the stream.
6465
+ - *Amazon Simple Queue Service* – The ARN of the queue.
6466
+ - *Amazon Managed Streaming for Apache Kafka* – The ARN of the cluster or the ARN of the VPC connection (for `cross-account event source mappings <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#msk-multi-vpc>`_ ).
6467
+ - *Amazon MQ* – The ARN of the broker.
6468
+ - *Amazon DocumentDB* – The ARN of the DocumentDB change stream.
6469
+
6400
6470
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-eventsourcearn
6401
6471
  '''
6402
6472
  result = self._values.get("event_source_arn")
@@ -6406,7 +6476,9 @@ class CfnEventSourceMappingProps:
6406
6476
  def filter_criteria(
6407
6477
  self,
6408
6478
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.FilterCriteriaProperty]]:
6409
- '''The filter criteria to control event filtering.
6479
+ '''An object that defines the filter criteria that determine whether Lambda should process an event.
6480
+
6481
+ For more information, see `Lambda event filtering <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html>`_ .
6410
6482
 
6411
6483
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-filtercriteria
6412
6484
  '''
@@ -6415,7 +6487,9 @@ class CfnEventSourceMappingProps:
6415
6487
 
6416
6488
  @builtins.property
6417
6489
  def function_response_types(self) -> typing.Optional[typing.List[builtins.str]]:
6418
- '''(Streams) A list of response types supported by the function.
6490
+ '''(Kinesis, DynamoDB Streams, and SQS) A list of current response type enums applied to the event source mapping.
6491
+
6492
+ Valid Values: ``ReportBatchItemFailures``
6419
6493
 
6420
6494
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-functionresponsetypes
6421
6495
  '''
@@ -6424,7 +6498,7 @@ class CfnEventSourceMappingProps:
6424
6498
 
6425
6499
  @builtins.property
6426
6500
  def kms_key_arn(self) -> typing.Optional[builtins.str]:
6427
- '''The Amazon Resource Name (ARN) of the KMS key.
6501
+ '''The ARN of the AWS Key Management Service ( AWS KMS ) customer managed key that Lambda uses to encrypt your function's `filter criteria <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics>`_ .
6428
6502
 
6429
6503
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-kmskeyarn
6430
6504
  '''
@@ -6433,7 +6507,13 @@ class CfnEventSourceMappingProps:
6433
6507
 
6434
6508
  @builtins.property
6435
6509
  def maximum_batching_window_in_seconds(self) -> typing.Optional[jsii.Number]:
6436
- '''(Streams) The maximum amount of time to gather records before invoking the function, in seconds.
6510
+ '''The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function.
6511
+
6512
+ *Default ( Kinesis , DynamoDB , Amazon SQS event sources)* : 0
6513
+
6514
+ *Default ( Amazon MSK , Kafka, Amazon MQ , Amazon DocumentDB event sources)* : 500 ms
6515
+
6516
+ *Related setting:* For Amazon SQS event sources, when you set ``BatchSize`` to a value greater than 10, you must set ``MaximumBatchingWindowInSeconds`` to at least 1.
6437
6517
 
6438
6518
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumbatchingwindowinseconds
6439
6519
  '''
@@ -6442,7 +6522,13 @@ class CfnEventSourceMappingProps:
6442
6522
 
6443
6523
  @builtins.property
6444
6524
  def maximum_record_age_in_seconds(self) -> typing.Optional[jsii.Number]:
6445
- '''(Streams) The maximum age of a record that Lambda sends to a function for processing.
6525
+ '''(Kinesis and DynamoDB Streams only) Discard records older than the specified age.
6526
+
6527
+ The default value is -1,
6528
+ which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records.
6529
+ .. epigraph::
6530
+
6531
+ The minimum valid value for maximum record age is 60s. Although values less than 60 and greater than -1 fall within the parameter's absolute range, they are not allowed
6446
6532
 
6447
6533
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumrecordageinseconds
6448
6534
  '''
@@ -6451,7 +6537,10 @@ class CfnEventSourceMappingProps:
6451
6537
 
6452
6538
  @builtins.property
6453
6539
  def maximum_retry_attempts(self) -> typing.Optional[jsii.Number]:
6454
- '''(Streams) The maximum number of times to retry when the function returns an error.
6540
+ '''(Kinesis and DynamoDB Streams only) Discard records after the specified number of retries.
6541
+
6542
+ The default value is -1,
6543
+ 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.
6455
6544
 
6456
6545
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumretryattempts
6457
6546
  '''
@@ -6462,7 +6551,9 @@ class CfnEventSourceMappingProps:
6462
6551
  def metrics_config(
6463
6552
  self,
6464
6553
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.MetricsConfigProperty]]:
6465
- '''Metrics config for Event Source Mapping Metrics.
6554
+ '''The metrics configuration for your event source.
6555
+
6556
+ For more information, see `Event source mapping metrics <https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics>`_ .
6466
6557
 
6467
6558
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-metricsconfig
6468
6559
  '''
@@ -6471,7 +6562,9 @@ class CfnEventSourceMappingProps:
6471
6562
 
6472
6563
  @builtins.property
6473
6564
  def parallelization_factor(self) -> typing.Optional[jsii.Number]:
6474
- '''(Streams) The number of batches to process from each shard concurrently.
6565
+ '''(Kinesis and DynamoDB Streams only) The number of batches to process concurrently from each shard.
6566
+
6567
+ The default value is 1.
6475
6568
 
6476
6569
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-parallelizationfactor
6477
6570
  '''
@@ -6482,7 +6575,9 @@ class CfnEventSourceMappingProps:
6482
6575
  def provisioned_poller_config(
6483
6576
  self,
6484
6577
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.ProvisionedPollerConfigProperty]]:
6485
- '''ProvisionedPollerConfig.
6578
+ '''(Amazon MSK and self-managed Apache Kafka only) The provisioned mode configuration for the event source.
6579
+
6580
+ For more information, see `provisioned mode <https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode>`_ .
6486
6581
 
6487
6582
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-provisionedpollerconfig
6488
6583
  '''
@@ -6491,7 +6586,7 @@ class CfnEventSourceMappingProps:
6491
6586
 
6492
6587
  @builtins.property
6493
6588
  def queues(self) -> typing.Optional[typing.List[builtins.str]]:
6494
- '''(ActiveMQ) A list of ActiveMQ queues.
6589
+ '''(Amazon MQ) The name of the Amazon MQ broker destination queue to consume.
6495
6590
 
6496
6591
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-queues
6497
6592
  '''
@@ -6502,7 +6597,9 @@ class CfnEventSourceMappingProps:
6502
6597
  def scaling_config(
6503
6598
  self,
6504
6599
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.ScalingConfigProperty]]:
6505
- '''The scaling configuration for the event source.
6600
+ '''(Amazon SQS only) The scaling configuration for the event source.
6601
+
6602
+ For more information, see `Configuring maximum concurrency for Amazon SQS event sources <https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency>`_ .
6506
6603
 
6507
6604
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-scalingconfig
6508
6605
  '''
@@ -6513,7 +6610,7 @@ class CfnEventSourceMappingProps:
6513
6610
  def self_managed_event_source(
6514
6611
  self,
6515
6612
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.SelfManagedEventSourceProperty]]:
6516
- '''The configuration used by AWS Lambda to access a self-managed event source.
6613
+ '''The self-managed Apache Kafka cluster for your event source.
6517
6614
 
6518
6615
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-selfmanagedeventsource
6519
6616
  '''
@@ -6524,7 +6621,7 @@ class CfnEventSourceMappingProps:
6524
6621
  def self_managed_kafka_event_source_config(
6525
6622
  self,
6526
6623
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.SelfManagedKafkaEventSourceConfigProperty]]:
6527
- '''Specific configuration settings for a Self-Managed Apache Kafka event source.
6624
+ '''Specific configuration settings for a self-managed Apache Kafka event source.
6528
6625
 
6529
6626
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-selfmanagedkafkaeventsourceconfig
6530
6627
  '''
@@ -6535,7 +6632,7 @@ class CfnEventSourceMappingProps:
6535
6632
  def source_access_configurations(
6536
6633
  self,
6537
6634
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnEventSourceMapping.SourceAccessConfigurationProperty]]]]:
6538
- '''A list of SourceAccessConfiguration.
6635
+ '''An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.
6539
6636
 
6540
6637
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-sourceaccessconfigurations
6541
6638
  '''
@@ -6544,9 +6641,11 @@ class CfnEventSourceMappingProps:
6544
6641
 
6545
6642
  @builtins.property
6546
6643
  def starting_position(self) -> typing.Optional[builtins.str]:
6547
- '''The position in a stream from which to start reading.
6644
+ '''The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB.
6548
6645
 
6549
- Required for Amazon Kinesis and Amazon DynamoDB Streams sources.
6646
+ - *LATEST* - Read only new records.
6647
+ - *TRIM_HORIZON* - Process all available records.
6648
+ - *AT_TIMESTAMP* - Specify a time from which to start reading records.
6550
6649
 
6551
6650
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingposition
6552
6651
  '''
@@ -6555,7 +6654,9 @@ class CfnEventSourceMappingProps:
6555
6654
 
6556
6655
  @builtins.property
6557
6656
  def starting_position_timestamp(self) -> typing.Optional[jsii.Number]:
6558
- '''With StartingPosition set to AT_TIMESTAMP, the time from which to start reading, in Unix time seconds.
6657
+ '''With ``StartingPosition`` set to ``AT_TIMESTAMP`` , the time from which to start reading, in Unix time seconds.
6658
+
6659
+ ``StartingPositionTimestamp`` cannot be in the future.
6559
6660
 
6560
6661
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingpositiontimestamp
6561
6662
  '''
@@ -6564,7 +6665,11 @@ class CfnEventSourceMappingProps:
6564
6665
 
6565
6666
  @builtins.property
6566
6667
  def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
6567
- '''A list of tags to apply to event source mapping resource.
6668
+ '''A list of tags to add to the event source mapping.
6669
+
6670
+ .. epigraph::
6671
+
6672
+ You must have the ``lambda:TagResource`` , ``lambda:UntagResource`` , and ``lambda:ListTags`` permissions for your `IAM principal <https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html>`_ to manage the AWS CloudFormation stack. If you don't have these permissions, there might be unexpected behavior with stack-level tags propagating to the resource during resource creation and update.
6568
6673
 
6569
6674
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-tags
6570
6675
  '''
@@ -6573,7 +6678,7 @@ class CfnEventSourceMappingProps:
6573
6678
 
6574
6679
  @builtins.property
6575
6680
  def topics(self) -> typing.Optional[typing.List[builtins.str]]:
6576
- '''(Kafka) A list of Kafka topics.
6681
+ '''The name of the Kafka topic.
6577
6682
 
6578
6683
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-topics
6579
6684
  '''
@@ -6582,7 +6687,9 @@ class CfnEventSourceMappingProps:
6582
6687
 
6583
6688
  @builtins.property
6584
6689
  def tumbling_window_in_seconds(self) -> typing.Optional[jsii.Number]:
6585
- '''(Streams) Tumbling window (non-overlapping time window) duration to perform aggregations.
6690
+ '''(Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources.
6691
+
6692
+ A value of 0 seconds indicates no tumbling window.
6586
6693
 
6587
6694
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-tumblingwindowinseconds
6588
6695
  '''
@@ -11450,7 +11557,7 @@ class Code(metaclass=jsii.JSIIAbstractClass, jsii_type="aws-cdk-lib.aws_lambda.C
11450
11557
  def from_inline(cls, code: builtins.str) -> "InlineCode":
11451
11558
  '''Inline code for Lambda handler.
11452
11559
 
11453
- :param code: The actual handler code (limited to 4KiB).
11560
+ :param code: The actual handler code (the resulting zip file cannot exceed 4MB).
11454
11561
 
11455
11562
  :return: ``LambdaInlineCode`` with inline code.
11456
11563
  '''
@@ -20784,7 +20891,8 @@ class ProvisionedPollerConfig:
20784
20891
  maximum_pollers: typing.Optional[jsii.Number] = None,
20785
20892
  minimum_pollers: typing.Optional[jsii.Number] = None,
20786
20893
  ) -> None:
20787
- '''
20894
+ '''(Amazon MSK and self-managed Apache Kafka only) The provisioned mode configuration for the event source.
20895
+
20788
20896
  :param maximum_pollers: The maximum number of pollers that can be provisioned. Default: - 200
20789
20897
  :param minimum_pollers: The minimum number of pollers that should be provisioned. Default: - 1
20790
20898