/2015-03-31/event-source-mappings/{UUID}

The AWS Lambda multi-region endpoint

http://lambda.{region}.amazonaws.com

PUT

Updates an event source mapping. You can change the function that Lambda invokes, or pause invocation and resume later from the same location.

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.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request PUT 'http://lambda.{region}.amazonaws.com/2015-03-31/event-source-mappings/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "FunctionName": "string",
    "Enabled": true,
    "BatchSize": 1,
    "MaximumBatchingWindowInSeconds": 0,
    "DestinationConfig": {
        "OnSuccess": {
            "Destination": "string"
        },
        "OnFailure": {
            "Destination": "string"
        }
    },
    "MaximumRecordAgeInSeconds": -1,
    "BisectBatchOnFunctionError": true,
    "MaximumRetryAttempts": -1,
    "ParallelizationFactor": 1,
    "SourceAccessConfigurations": [
        {
            "Type": "BASIC_AUTH",
            "URI": "string"
        }
    ],
    "TumblingWindowInSeconds": 0,
    "FunctionResponseTypes": [
        "ReportBatchItemFailures"
    ]
}'

Response Example

202 - Example 1

{
    "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

Path Params

Body Params application/json

Examples

Responses

🟢202Success

application/json

Body

🟠480ServiceException

🟠481ResourceNotFoundException

🟠482InvalidParameterValueException

🟠483TooManyRequestsException

🟠484ResourceConflictException

🟠485ResourceInUseException

Modified at 2022-09-10 19:49:51

/2015-03-31/event-source-mappings/{UUID}

/2015-03-31/functions/{FunctionName}