GetEventSourceMapping

Restituisce i dettagli relativi a una mappatura dell'origine eventi. È possibile ottenere l'identificatore di una mappatura dall'output di ListEventSourceMappings.

Sintassi della richiesta

GET /2015-03-31/event-source-mappings/UUID HTTP/1.1

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

UUID

L'identificatore della mappatura dell'origine eventi.

Campo obbligatorio: sì

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "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"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

AmazonManagedKafkaEventSourceConfig

Impostazioni di configurazione specifiche per un'origine eventi di Streaming gestito da Amazon per Apache Kafka (Amazon MSK).

Tipo: oggetto AmazonManagedKafkaEventSourceConfig

BatchSize

Il numero massimo di registri in ogni batch che Lambda estrae dal flusso o dalla coda e invia alla funzione. Lambda passa tutti i registri del batch alla funzione in una singola chiamata, fino al limite di payload per la chiamata sincrona (6 MB).

Valore di default: varia in base al servizio. Per Amazon SQS, il valore di default è 10. Per tutti gli altri servizi, il valore di default è 100.

Impostazione correlata: quando si imposta BatchSize su un valore maggiore di 10, è necessario impostare MaximumBatchingWindowInSeconds almeno su 1.

Tipo: integer

Intervallo valido: valore minimo di 1. Valore massimo pari a 10000.

BisectBatchOnFunctionError

(Solo per flussi Kinesis e DynamoDB) Se la funzione restituisce un errore, dividi il batch in due e riprova. Il valore predefinito è false.

Tipo: Booleano

DestinationConfig

(Solo Kinesis, DynamoDB Streams, Amazon MSK e sorgenti di eventi Apache Kafka autogestite) Un oggetto di configurazione che specifica la destinazione di un evento dopo l'elaborazione da Lambda.

Tipo: oggetto DestinationConfig

DocumentDBEventSourceConfig

Impostazioni di configurazione specifiche per un'origine degli eventi DocumentDB.

Tipo: oggetto DocumentDBEventSourceConfig

EventSourceArn

L'Amazon Resource Name (ARN) dell'origine eventi.

Tipo: stringa

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

FilterCriteria

Un oggetto che definisce i criteri di filtro che determinano se Lambda debba elaborare un evento. Per ulteriori informazioni, consultare Filtro eventi Lambda.

Tipo: oggetto FilterCriteria

FunctionArn

ARN della funzione Lambda.

Tipo: stringa

Modello: 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-_]+))?

FunctionResponseTypes

(Kinesis, DynamoDB Streams e Amazon SQS) Un elenco delle enumerazioni del tipo di risposta corrente applicate allo strumento di mappatura dell'origine degli eventi.

Tipo: matrice di stringhe

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

Valori validi: ReportBatchItemFailures

LastModified

Data dell'ultimo aggiornamento o cambiamento di stato della mappatura dell'origine eventi, in secondi di tempo Unix.

Tipo: Timestamp

LastProcessingResult

Il risultato dell'ultima invocazione Lambda della funzione.

Tipo: stringa

MaximumBatchingWindowInSeconds

Il tempo massimo, in secondi, per la raccolta dei registri da parte di Lambda prima di richiamare la funzione. È possibile configurare MaximumBatchingWindowInSeconds su qualsiasi valore da 0 secondi a 300 secondi con incrementi di secondi.

Per i flussi e le origini eventi Amazon SQS, la finestra di batch di default è 0 secondi. Per le origini degli eventi di Amazon MSK, Apache Kafka autogestito, Amazon MQ e DocumentDB la finestra di batch predefinita è 500 ms. Poiché è possibile modificare MaximumBatchingWindowInSeconds solo in incrementi di secondi, non puoi tornare alla finestra di batch predefinita di 500 ms dopo averla modificata. Per ripristinare la finestra di batch predefinita, è necessario creare una nuova mappatura dell'origine eventi.

Impostazione correlata: per i flussi e le origini eventi di Amazon SQS, quando si imposta BatchSize su un valore maggiore di 10, è necessario impostare MaximumBatchingWindowInSeconds almeno su 1.

Tipo: integer

Intervallo valido: valore minimo di 0. Valore massimo pari a 300.

MaximumRecordAgeInSeconds

(Solo per flussi Kinesis e DynamoDB) Elimina i record più vecchi dell'età specificata. Il valore predefinito è -1, che consente di impostare l'età massima su infinita. Quando il valore è impostato su infinito, Lambda non scarta mai i vecchi record.

Nota

Il valore minimo valido per l'età massima del record è 60 s. Sebbene i valori inferiori a 60 e superiori a -1 rientrino nell'intervallo assoluto del parametro, non sono consentiti.

Tipo: integer

Intervallo valido: valore minimo di -1. Valore massimo pari a 604800.

MaximumRetryAttempts

(Solo per flussi Kinesis e DynamoDB) Elimina i record dopo il numero di tentativi specificato. Il valore predefinito è -1, che consente di impostare il numero massimo di tentativi su infinito. Quando MaximumRetryAttempts è infinito, Lambda ritenta i record non riusciti fino alla scadenza del record nell'origine dell'evento.

Tipo: integer

Intervallo valido: valore minimo di -1. Valore massimo pari a 10000.

ParallelizationFactor

(Solo per flussi Kinesis e DynamoDB) Il numero di batch da elaborare contemporaneamente da ogni partizione. Il valore predefinito è 1.

Tipo: integer

Intervallo valido: valore minimo di 1. valore massimo pari a 10.

Queues

(Amazon MQ): il nome della coda di destinazione del broker Amazon MQ da utilizzare.

Tipo: matrice di stringhe

Membri dell'array: numero minimo di 1 elemento.

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 1000.

Modello: [\s\S]*

ScalingConfig

(Solo Amazon SQS) La configurazione di scalabilità per l'origine dell'evento. Per ulteriori informazioni, consulta Configurazione della simultaneità massima per le origini eventi di Amazon SQS.

Tipo: oggetto ScalingConfig

SelfManagedEventSource

Il cluster Apache Kafka gestito dal cliente per l'origine eventi.

Tipo: oggetto SelfManagedEventSource

SelfManagedKafkaEventSourceConfig

Impostazioni di configurazione specifiche per un'origine eventi Apache Kafka autogestito.

Tipo: oggetto SelfManagedKafkaEventSourceConfig

SourceAccessConfigurations

Un array del protocollo di autenticazione, dei componenti VPC o dell'host virtuale per proteggere e definire l'origine eventi.

Tipo: matrice di oggetti SourceAccessConfiguration

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 22 elementi.

StartingPosition

La posizione in un flusso da cui iniziare la lettura. Richiesto per le origini di eventi Amazon Kinesis e flussi Amazon DynamoDB. AT_TIMESTAMP è supportato solo per flussi Amazon Kinesis, Amazon DocumentDB, Amazon MSK e Apache Kafka autogestito.

Tipo: stringa

Valori validi: TRIM_HORIZON | LATEST | AT_TIMESTAMP

StartingPositionTimestamp

Con StartingPosition impostato su AT_TIMESTAMP, il tempo da cui avviare la lettura, espresso in secondi di tempo Unix. StartingPositionTimestamp non può essere nel futuro.

Tipo: Timestamp

State

Lo stato della mappatura dell'origine eventi. Può avere uno dei seguenti valori: Creating, Enabling, Enabled, Disabling, Disabled, Updating o Deleting.

Tipo: stringa

StateTransitionReason

Indica se un utente o Lambda ha apportato l'ultima modifica alla mappatura dell'origine eventi.

Tipo: stringa

Topics

Il nome dell'argomento Kafka.

Tipo: matrice di stringhe

Membri dell'array: numero minimo di 1 elemento.

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 249.

Modello: ^[^.]([a-zA-Z0-9\-_.]+)

TumblingWindowInSeconds

(Solo per flussi Kinesis e DynamoDB) La durata in secondi di una finestra di elaborazione per le origini eventi dei flussi DynamoDB e Kinesis. Un valore di 0 secondi indica l'assenza di finestre a cascata.

Tipo: integer

Intervallo valido: valore minimo di 0. Valore massimo pari a 900.

UUID

L'identificatore della mappatura dell'origine eventi.

Tipo: stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InvalidParameterValueException

Uno dei parametri della richiesta non è valido.

Codice di stato HTTP: 400

ResourceNotFoundException

La risorsa specificata nella richiesta non esiste.

Codice di stato HTTP: 404

ServiceException

Il servizio AWS Lambda ha riscontrato un errore interno.

Codice di stato HTTP: 500

TooManyRequestsException

È stato superato il limite di throughput della richiesta. Per ulteriori informazioni, consulta la pagina relativa alle quote di .

Codice di stato HTTP: 429

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:

• Interfaccia a riga di comando AWS

• SDK AWS per .NET

• SDK AWS per C++

• SDK AWS per Go

• SDK AWS per Java V2

• AWSSDK per V3 JavaScript

• SDK AWS per PHP V3

• SDK AWS per Python

• SDK AWS per Ruby V3