ListEventSourceMappings - AWS Lambda

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: