ListEventSourceMappings
Enumera los mapeos de fuente de eventos. Especifique un EventSourceArn
para mostrar solo las asignaciones de origen de eventos para un único origen de eventos.
Sintaxis de la solicitud
GET /2015-03-31/event-source-mappings/?EventSourceArn=EventSourceArn
&FunctionName=FunctionName
&Marker=Marker
&MaxItems=MaxItems
HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- EventSourceArn
-
El nombre de recurso de Amazon (ARN) del origen de evento.
-
Amazon Kinesis: el ARN del flujo de datos o un consumidor de flujos.
-
Amazon DynamoDB Streams: el ARN del flujo.
-
Amazon Simple Queue Service: el ARN de la cola.
-
Amazon Managed Streaming para Apache Kafka: el ARN del clúster o el ARN de la conexión de VPC (para la asignación de orígenes de eventos entre cuentas).
-
Amazon MQ: el ARN del agente.
-
Amazon DocumentDB: el ARN del flujo de cambios de DocumentDB.
Patrón:
arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)
-
- FunctionName
-
El nombre de la función de Lambda.
Formatos de nombre
-
Nombre de la función:
MyFunction
. -
ARN de la función:
arn:aws:lambda:us-west-2:123456789012:function:MyFunction
. -
ARN de la versión o el alias:
arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD
. -
ARN parcial:
123456789012:function:MyFunction
.
La limitación de longitud se aplica únicamente al ARN completo. Si solo especifica el nombre de la función, el límite son 64 caracteres de longitud.
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 140 caracteres.
Patrón:
(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?
-
- Marker
-
Un token de paginación devuelto por una llamada anterior.
- MaxItems
-
El número máximo de mapeos de fuente de eventos que devolver. Tenga en cuenta que ListEventSourceMappings devuelve un máximo de 100 elementos en cada respuesta, incluso si establece el número más alto.
Rango válido: valor mínimo de 1. Valor máximo de 10000.
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"EventSourceMappings": [
{
"AmazonManagedKafkaEventSourceConfig": {
"ConsumerGroupId": "string"
},
"BatchSize": number,
"BisectBatchOnFunctionError": boolean,
"DestinationConfig": {
"OnFailure": {
"Destination": "string"
},
"OnSuccess": {
"Destination": "string"
}
},
"DocumentDBEventSourceConfig": {
"CollectionName": "string",
"DatabaseName": "string",
"FullDocument": "string"
},
"EventSourceArn": "string",
"FilterCriteria": {
"Filters": [
{
"Pattern": "string"
}
]
},
"FunctionArn": "string",
"FunctionResponseTypes": [ "string" ],
"LastModified": number,
"LastProcessingResult": "string",
"MaximumBatchingWindowInSeconds": number,
"MaximumRecordAgeInSeconds": number,
"MaximumRetryAttempts": number,
"ParallelizationFactor": number,
"Queues": [ "string" ],
"ScalingConfig": {
"MaximumConcurrency": number
},
"SelfManagedEventSource": {
"Endpoints": {
"string" : [ "string" ]
}
},
"SelfManagedKafkaEventSourceConfig": {
"ConsumerGroupId": "string"
},
"SourceAccessConfigurations": [
{
"Type": "string",
"URI": "string"
}
],
"StartingPosition": "string",
"StartingPositionTimestamp": number,
"State": "string",
"StateTransitionReason": "string",
"Topics": [ "string" ],
"TumblingWindowInSeconds": number,
"UUID": "string"
}
],
"NextMarker": "string"
}
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- EventSourceMappings
-
Una lista de mapeos de fuentes de eventos.
Tipo: Matriz de objetos EventSourceMappingConfiguration
- NextMarker
-
Un token de paginación que se devuelve cuando la respuesta no contiene todos los mapeos de fuente de eventos.
Tipo: cadena
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InvalidParameterValueException
-
Uno de los parámetros de la solicitud no es válido.
Código de estado HTTP: 400
- ResourceNotFoundException
-
El recurso especificado en la solicitud no existe.
Código de estado HTTP: 404
- ServiceException
-
El servicio AWS Lambda detectó un error interno.
Código de estado HTTP: 500
- TooManyRequestsException
-
Se ha superado el límite de rendimiento de la solicitud. Para obtener más información, consulte Cuotas de Lambda.
Código de estado HTTP: 429
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: