AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Creates a mapping between an event source and an Lambda function. Lambda reads items from the event source and invokes the function.
For details about how to configure different event sources, see the following topics.
The following error handling options are available only 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.
For information about which configuration parameters apply to each event source, see the following topics.
For .NET Core this operation is only available in asynchronous form. Please refer to CreateEventSourceMappingAsync.
Namespace: Amazon.Lambda
Assembly: AWSSDK.Lambda.dll
Version: 3.x.y.z
public abstract CreateEventSourceMappingResponse CreateEventSourceMapping( CreateEventSourceMappingRequest request )
Container for the necessary parameters to execute the CreateEventSourceMapping service method.
| Exception | Condition |
|---|---|
| InvalidParameterValueException | One of the parameters in the request is not valid. |
| ResourceConflictException | The resource already exists, or another operation is in progress. |
| ResourceNotFoundException | The resource specified in the request does not exist. |
| ServiceException | The Lambda service encountered an internal error. |
| TooManyRequestsException | The request throughput limit was exceeded. For more information, see Lambda quotas. |
The following example creates a mapping between an SQS queue and the my-function Lambda function.
var response = client.CreateEventSourceMapping(new CreateEventSourceMappingRequest
{
BatchSize = 5,
EventSourceArn = "arn:aws:sqs:us-west-2:123456789012:my-queue",
FunctionName = "my-function"
});
int batchSize = response.BatchSize;
string eventSourceArn = response.EventSourceArn;
string functionArn = response.FunctionArn;
DateTime lastModified = response.LastModified;
string state = response.State;
string stateTransitionReason = response.StateTransitionReason;
string uuid = response.UUID;
.NET Framework:
Supported in: 4.5, 4.0, 3.5