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.
- aws_cdk/__init__.py +528 -161
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.171.1.jsii.tgz → aws-cdk-lib@2.173.0.jsii.tgz} +0 -0
- aws_cdk/aws_amazonmq/__init__.py +40 -40
- aws_cdk/aws_apigateway/__init__.py +1357 -120
- aws_cdk/aws_applicationautoscaling/__init__.py +141 -66
- aws_cdk/aws_appsync/__init__.py +163 -139
- aws_cdk/aws_autoscaling/__init__.py +96 -30
- aws_cdk/aws_bedrock/__init__.py +80 -44
- aws_cdk/aws_chatbot/__init__.py +803 -2
- aws_cdk/aws_cleanrooms/__init__.py +4 -6
- aws_cdk/aws_cloudformation/__init__.py +240 -159
- aws_cdk/aws_cloudfront/__init__.py +15 -7
- aws_cdk/aws_cloudtrail/__init__.py +802 -13
- aws_cdk/aws_cloudwatch/__init__.py +51 -14
- aws_cdk/aws_codebuild/__init__.py +39 -0
- aws_cdk/aws_codepipeline/__init__.py +4 -4
- aws_cdk/aws_cognito/__init__.py +1032 -43
- aws_cdk/aws_config/__init__.py +13 -10
- aws_cdk/aws_connect/__init__.py +454 -23
- aws_cdk/aws_connectcampaignsv2/__init__.py +187 -176
- aws_cdk/aws_customerprofiles/__init__.py +3148 -0
- aws_cdk/aws_docdb/__init__.py +128 -0
- aws_cdk/aws_dynamodb/__init__.py +256 -0
- aws_cdk/aws_ec2/__init__.py +976 -27
- aws_cdk/aws_ecs/__init__.py +37 -20
- aws_cdk/aws_eks/__init__.py +771 -0
- aws_cdk/aws_elasticache/__init__.py +22 -22
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +441 -177
- aws_cdk/aws_events/__init__.py +550 -30
- aws_cdk/aws_fsx/__init__.py +134 -10
- aws_cdk/aws_imagebuilder/__init__.py +8 -8
- aws_cdk/aws_invoicing/__init__.py +651 -0
- aws_cdk/aws_iot/__init__.py +70 -26
- aws_cdk/aws_iotfleetwise/__init__.py +1033 -382
- aws_cdk/aws_iotsitewise/__init__.py +158 -0
- aws_cdk/aws_ivs/__init__.py +43 -31
- aws_cdk/aws_kendra/__init__.py +4 -0
- aws_cdk/aws_lakeformation/__init__.py +2 -1
- aws_cdk/aws_lambda/__init__.py +272 -164
- aws_cdk/aws_lambda_event_sources/__init__.py +2 -1
- aws_cdk/aws_lambda_nodejs/__init__.py +11 -11
- aws_cdk/aws_logs/__init__.py +532 -0
- aws_cdk/aws_m2/__init__.py +289 -0
- aws_cdk/aws_mediaconnect/__init__.py +24 -14
- aws_cdk/aws_medialive/__init__.py +2359 -5
- aws_cdk/aws_mediapackage/__init__.py +3 -9
- aws_cdk/aws_mediapackagev2/__init__.py +19 -17
- aws_cdk/aws_memorydb/__init__.py +664 -4
- aws_cdk/aws_mwaa/__init__.py +6 -6
- aws_cdk/aws_opensearchserverless/__init__.py +249 -1
- aws_cdk/aws_pipes/__init__.py +14 -30
- aws_cdk/aws_qbusiness/__init__.py +2021 -67
- aws_cdk/aws_quicksight/__init__.py +8270 -10
- aws_cdk/aws_rbin/__init__.py +53 -34
- aws_cdk/aws_rds/__init__.py +170 -8
- aws_cdk/aws_resourcegroups/__init__.py +362 -4
- aws_cdk/aws_route53/__init__.py +1177 -10
- aws_cdk/aws_route53_targets/__init__.py +297 -91
- aws_cdk/aws_route53resolver/__init__.py +19 -8
- aws_cdk/aws_s3/__init__.py +4 -4
- aws_cdk/aws_s3express/__init__.py +421 -9
- aws_cdk/aws_sagemaker/__init__.py +905 -119
- aws_cdk/aws_secretsmanager/__init__.py +20 -6
- aws_cdk/aws_securityhub/__init__.py +64 -32
- aws_cdk/aws_servicediscovery/__init__.py +43 -0
- aws_cdk/aws_ses/__init__.py +188 -41
- aws_cdk/aws_stepfunctions_tasks/__init__.py +190 -35
- aws_cdk/aws_synthetics/__init__.py +7 -5
- aws_cdk/aws_vpclattice/__init__.py +1479 -122
- aws_cdk/aws_wisdom/__init__.py +8509 -1502
- aws_cdk/aws_workspacesweb/__init__.py +1081 -0
- {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/RECORD +78 -77
- {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.171.1.dist-info → aws_cdk_lib-2.173.0.dist-info}/top_level.txt +0 -0
aws_cdk/aws_lambda/__init__.py
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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:
|
|
4738
|
-
:param enabled:
|
|
4739
|
-
:param event_source_arn: The Amazon Resource Name (ARN) of the event source.
|
|
4740
|
-
:param filter_criteria:
|
|
4741
|
-
:param function_response_types: (Streams) A list of response
|
|
4742
|
-
:param kms_key_arn: The
|
|
4743
|
-
:param maximum_batching_window_in_seconds:
|
|
4744
|
-
:param maximum_record_age_in_seconds: (Streams) The maximum age
|
|
4745
|
-
:param maximum_retry_attempts: (Streams) The maximum number of
|
|
4746
|
-
:param metrics_config:
|
|
4747
|
-
:param parallelization_factor: (Streams) The number of batches to process from each shard
|
|
4748
|
-
:param provisioned_poller_config:
|
|
4749
|
-
:param queues: (
|
|
4750
|
-
:param scaling_config: The scaling configuration for the event source.
|
|
4751
|
-
:param self_managed_event_source: The
|
|
4752
|
-
:param self_managed_kafka_event_source_config: Specific configuration settings for a
|
|
4753
|
-
:param source_access_configurations:
|
|
4754
|
-
:param starting_position: The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB
|
|
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
|
|
4757
|
-
:param topics:
|
|
4758
|
-
:param tumbling_window_in_seconds: (Streams)
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
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
|
|
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
|
|
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
|
-
'''
|
|
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
|
-
'''(
|
|
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
|
-
'''(
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
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
|
-
'''(
|
|
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
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
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)
|
|
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
|
|
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
|
|
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:
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
5419
|
+
'''Specific configuration settings for a DocumentDB event source.
|
|
5407
5420
|
|
|
5408
|
-
:param collection_name: The collection
|
|
5409
|
-
:param database_name: The database
|
|
5410
|
-
:param full_document:
|
|
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
|
|
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
|
|
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
|
-
'''
|
|
5475
|
+
'''Determines what DocumentDB sends to your event stream during document update operations.
|
|
5461
5476
|
|
|
5462
|
-
|
|
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
|
|
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:
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
5561
|
+
'''An object that contains the filters for an event source.
|
|
5547
5562
|
|
|
5548
|
-
:param filters:
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
5616
|
+
'''A structure within a ``FilterCriteria`` object that defines an event filtering pattern.
|
|
5602
5617
|
|
|
5603
|
-
:param pattern:
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
5673
|
+
'''The metrics configuration for your event source.
|
|
5657
5674
|
|
|
5658
|
-
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
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:
|
|
5773
|
-
:param minimum_pollers:
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
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
|
-
|
|
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
|
-
'''
|
|
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
|
|
5921
|
+
'''The self-managed Apache Kafka cluster for your event source.
|
|
5895
5922
|
|
|
5896
|
-
:param endpoints: The
|
|
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
|
|
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
|
|
5980
|
+
'''Specific configuration settings for a self-managed Apache Kafka event source.
|
|
5954
5981
|
|
|
5955
|
-
:param consumer_group_id: The identifier for the Kafka
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
6012
|
-
:param uri: The
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
6141
|
-
:param enabled:
|
|
6142
|
-
:param event_source_arn: The Amazon Resource Name (ARN) of the event source.
|
|
6143
|
-
:param filter_criteria:
|
|
6144
|
-
:param function_response_types: (Streams) A list of response
|
|
6145
|
-
:param kms_key_arn: The
|
|
6146
|
-
:param maximum_batching_window_in_seconds:
|
|
6147
|
-
:param maximum_record_age_in_seconds: (Streams) The maximum age
|
|
6148
|
-
:param maximum_retry_attempts: (Streams) The maximum number of
|
|
6149
|
-
:param metrics_config:
|
|
6150
|
-
:param parallelization_factor: (Streams) The number of batches to process from each shard
|
|
6151
|
-
:param provisioned_poller_config:
|
|
6152
|
-
:param queues: (
|
|
6153
|
-
:param scaling_config: The scaling configuration for the event source.
|
|
6154
|
-
:param self_managed_event_source: The
|
|
6155
|
-
:param self_managed_kafka_event_source_config: Specific configuration settings for a
|
|
6156
|
-
:param source_access_configurations:
|
|
6157
|
-
:param starting_position: The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB
|
|
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
|
|
6160
|
-
:param topics:
|
|
6161
|
-
:param tumbling_window_in_seconds: (Streams)
|
|
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
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
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
|
|
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
|
|
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
|
-
'''
|
|
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
|
-
'''(
|
|
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
|
-
'''(
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
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
|
-
'''(
|
|
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
|
|
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
|
|
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
|
-
'''
|
|
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
|
-
|
|
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
|
|
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
|
-
'''
|
|
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)
|
|
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 (
|
|
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
|
|