ListEventSourceMappings - AWS Lambda

ListEventSourceMappings

Lista os mapeamentos de origem do evento. Especifique um EventSourceArn para mostrar apenas os mapeamentos de origem de eventos para uma única origem de eventos.

Sintaxe da Solicitação

GET /2015-03-31/event-source-mappings/?EventSourceArn=EventSourceArn&FunctionName=FunctionName&Marker=Marker&MaxItems=MaxItems HTTP/1.1

Parâmetros da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

EventSourceArn

O nome de recurso da Amazon (ARN) da origem do evento.

  • Amazon Kinesis: o ARN do fluxo de dados ou de um consumidor de fluxo.

  • Amazon DynamoDB Streams: o ARN do fluxo.

  • Amazon Simple Queue Service: o ARN da fila.

  • Amazon Managed Streaming for Apache Kafka: o ARN do cluster ou o ARN da conexão VPC (para mapeamentos da origem do evento entre contas).

  • Amazon MQ: o ARN do agente.

  • Amazon DocumentDB: o ARN do fluxo de alterações do DocumentDB.

Padrão: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

FunctionName

O nome da função do Lambda.

Formatos de nome
  • Nome da função: MyFunction.

  • ARN da função: arn:aws:lambda:us-west-2:123456789012:function:MyFunction.

  • ARN da versão ou do alias: arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD.

  • ARN parcial: 123456789012:function:MyFunction.

A restrição de comprimento se aplica apenas ao ARN completo. Se você especificar apenas o nome da função, ele será limitado a 64 caracteres.

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.

Padrão: (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

Um token de paginação retornado por uma chamada anterior.

MaxItems

O número máximo de mapeamentos de origem do evento a serem retornados. Observe que ListEventSourceMappings retorna um máximo de 100 itens em cada resposta, mesmo que você defina um número maior.

Intervalo válido: valor mínimo de 1. Valor máximo de 10000.

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da Resposta

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 Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

EventSourceMappings

Uma lista de mapeamentos da origem do evento.

Tipo: matriz de objetos EventSourceMappingConfiguration

NextMarker

Um token de paginação retornado quando a resposta não contém todos os mapeamentos de origem do evento.

Tipo: string

Erros

Para obter informações sobre os erros que todas as ações retornam, consulte Erros comuns.

InvalidParameterValueException

Um dos parâmetros da solicitação não é válido.

Código de Status HTTP: 400

ResourceNotFoundException

O recurso especificado na solicitação não existe.

Código de Status HTTP: 404

ServiceException

O serviço AWS Lambda encontrou um erro interno.

Código de Status HTTP: 500

TooManyRequestsException

O limite de throughput da solicitação foi excedido. Para obter mais informações, consulte Cotas do Lambda.

Código de status HTTP: 429

Ver também

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte: