/2015-03-31/event-source-mappings/

Creates a mapping between an event source and an Lambda function. Lambda reads items from the event source and triggers the function.

For details about each event source type, see the following topics. In particular, each of the topics describes the required and optional parameters for the specific event source.

The following error handling options are only available for stream sources (DynamoDB and Kinesis):

BisectBatchOnFunctionError - If the function returns an error, split the batch in two and retry.
DestinationConfig - Send discarded records to an Amazon SQS queue or Amazon SNS topic.
MaximumRecordAgeInSeconds - Discard records older than the specified age. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires
MaximumRetryAttempts - Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires.
ParallelizationFactor - Process multiple batches from each shard concurrently.

curl --location -g --request POST 'http://lambda.{region}.amazonaws.com/2015-03-31/event-source-mappings/' \ --header 'Content-Type: application/json' \ --data-raw '{ "EventSourceArn": "string", "FunctionName": "string", "Enabled": true, "BatchSize": 1, "MaximumBatchingWindowInSeconds": 0, "ParallelizationFactor": 1, "StartingPosition": "TRIM_HORIZON", "StartingPositionTimestamp": "2019-08-24T14:15:22Z", "DestinationConfig": { "OnSuccess": { "Destination": "string" }, "OnFailure": { "Destination": "string" } }, "MaximumRecordAgeInSeconds": -1, "BisectBatchOnFunctionError": true, "MaximumRetryAttempts": -1, "TumblingWindowInSeconds": 0, "Topics": [ "string" ], "Queues": [ "string" ], "SourceAccessConfigurations": [ { "Type": "BASIC_AUTH", "URI": "string" } ], "SelfManagedEventSource": { "Endpoints": { "property1": [ "string" ], "property2": [ "string" ] } }, "FunctionResponseTypes": [ "ReportBatchItemFailures" ] }'

{ "UUID": "string", "StartingPosition": "TRIM_HORIZON", "StartingPositionTimestamp": "string", "BatchSize": 0, "MaximumBatchingWindowInSeconds": 0, "ParallelizationFactor": 0, "EventSourceArn": "string", "FunctionArn": "string", "LastModified": "string", "LastProcessingResult": "string", "State": "string", "StateTransitionReason": "string", "DestinationConfig": { "OnSuccess": { "Destination": "string" }, "OnFailure": { "Destination": "string" } }, "Topics": [], "Queues": [], "SourceAccessConfigurations": [], "SelfManagedEventSource": { "Endpoints": { "property1": [ "string" ], "property2": [ "string" ] } }, "MaximumRecordAgeInSeconds": 0, "BisectBatchOnFunctionError": true, "MaximumRetryAttempts": 0, "TumblingWindowInSeconds": 0, "FunctionResponseTypes": [] }

Request

Responses