Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Lambda parameters for Amazon DynamoDB event source mappings

Focus mode
Lambda parameters for Amazon DynamoDB event source mappings - AWS Lambda

All Lambda event source types share the same CreateEventSourceMapping and UpdateEventSourceMapping API operations. However, only some of the parameters apply to DynamoDB Streams.

Parameter Required Default Notes

BatchSize

N

100

Maximum: 10,000

BisectBatchOnFunctionError

N

false

none

DestinationConfig

N

N/A

Standard Amazon SQS queue or standard Amazon SNS topic destination for discarded records

Enabled

N

true

none

EventSourceArn

Y

N/A

ARN of the data stream or a stream consumer

FilterCriteria

N

N/A

Control which events Lambda sends to your function

FunctionName

Y

N/A

none

FunctionResponseTypes

N

N/A

To let your function report specific failures in a batch, include the value ReportBatchItemFailures in FunctionResponseTypes. For more information, see Configuring partial batch response with DynamoDB and Lambda.

MaximumBatchingWindowInSeconds

N

0

none

MaximumRecordAgeInSeconds

N

-1

-1 means infinite: failed records are retried until the record expires. The data retention limit for DynamoDB Streams is 24 hours.

Minimum: -1

Maximum: 604,800

MaximumRetryAttempts

N

-1

-1 means infinite: failed records are retried until the record expires

Minimum: 0

Maximum: 10,000

ParallelizationFactor

N

1

Maximum: 10

StartingPosition

Y

N/A

TRIM_HORIZON or LATEST

TumblingWindowInSeconds

N

N/A

Minimum: 0

Maximum: 900

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.