Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AWS Lambda Event Source Mappings API

Map event sources such as Amazon SQS, Kinesis, and DynamoDB Streams to Lambda functions for automatic invocation

AWS Lambda Event Source Mappings API is one of 12 APIs that AWS Lambda publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Event Source Mappings. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, a JSON-LD context, an API reference, pricing, and 1 JSON Schema.

This API exposes 5 operations across 2 paths, and defines 7 schemas. It is described by OpenAPI 3.1.0, at version 2015-03-31.

Requests are made against a single base URL, https://lambda.{region}.amazonaws.com.

5 operations 2 paths 7 schemas 1 DELETE2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2015-03-31
Base URL
https://lambda.{region}.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

AWS Lambda Event Source Mappings API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (sigv4). By default, every request must be authenticated.

  • sigv4 — AWS Signature Version 4 authentication. Requests must be signed with valid AWS credentials that have the appropriate Lambda IAM permissions.

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Event Source Mappings 5

Map event sources such as Amazon SQS, Kinesis, and DynamoDB Streams to Lambda functions for automatic invocation

GET
/2015-03-31/event-source-mappings
Aws Lambda List Event Source Mappings
listEventSourceMappings 4 params → 200404
POST
/2015-03-31/event-source-mappings
Aws Lambda Create an Event Source Mapping
createEventSourceMapping body → 202400409
GET
/2015-03-31/event-source-mappings/{UUID}
Aws Lambda Get an Event Source Mapping
getEventSourceMapping 1 param → 200404
PUT
/2015-03-31/event-source-mappings/{UUID}
Aws Lambda Update an Event Source Mapping
updateEventSourceMapping 1 param body → 202404
DELETE
/2015-03-31/event-source-mappings/{UUID}
Aws Lambda Delete an Event Source Mapping
deleteEventSourceMapping 1 param → 202404

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are EventSourceMappingConfiguration (19 properties), CreateEventSourceMappingRequest (15 properties), UpdateEventSourceMappingRequest (12 properties), ErrorResponse (3 properties). Each schema is shown below with its type and property counts.

EventSourceMappingConfiguration
object
A mapping between an AWS resource and a Lambda function. Lambda reads items from the event source and invokes the function.
19 properties
DestinationConfig
object
Configuration for failed invocation destinations. Specify an SQS queue or SNS topic to receive records of failed asynchronous invocations or event source mappi…
2 properties
FilterCriteria
object
An object that contains the filters for an event source. Event filtering enables you to control which records from an event source Lambda sends to your functio…
1 property
ListEventSourceMappingsResponse
object
Paginated list of event source mappings
2 properties
UpdateEventSourceMappingRequest
object
Request body for updating an event source mapping
12 properties
ErrorResponse
object
Error response from the Lambda API
3 properties
CreateEventSourceMappingRequest
object
Request body for creating an event source mapping
15 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aws-lambda-event-source-mappings-api-openapi.yml Raw ↑

Other APIs AWS Lambda publishes across the network.

AWS Lambda Extensions API
AWS Lambda Telemetry API
AWS Lambda Runtime API
AWS Lambda Logs API
AWS Lambda Aliases API
AWS Lambda Concurrency API
AWS Lambda Function URL API
AWS Lambda Functions API
AWS Lambda Layers API
AWS Lambda Tags API
AWS Lambda Versions API