EventSourceMappingConfiguration

Una mappatura tra una risorsa AWS e una funzione Lambda. Per informazioni dettagliate, vedi CreateEventSourceMapping.

Indice

AmazonManagedKafkaEventSourceConfig

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

Tipo: oggetto AmazonManagedKafkaEventSourceConfig

Campo obbligatorio: no

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.

Campo obbligatorio: no

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

Campo obbligatorio: no

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

Campo obbligatorio: no

DocumentDBEventSourceConfig

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

Tipo: oggetto DocumentDBEventSourceConfig

Campo obbligatorio: no

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})?:(.*)

Campo obbligatorio: no

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

Campo obbligatorio: no

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

Campo obbligatorio: no

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

Campo obbligatorio: no

LastModified

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

Tipo: Timestamp

Campo obbligatorio: no

LastProcessingResult

Il risultato dell'ultima invocazione Lambda della funzione.

Tipo: string

Campo obbligatorio: no

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.

Campo obbligatorio: no

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.

Campo obbligatorio: no

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.

Campo obbligatorio: no

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.

Campo obbligatorio: no

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]*

Campo obbligatorio: no

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

Campo obbligatorio: no

SelfManagedEventSource

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

Tipo: oggetto SelfManagedEventSource

Campo obbligatorio: no

SelfManagedKafkaEventSourceConfig

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

Tipo: oggetto SelfManagedKafkaEventSourceConfig

Campo obbligatorio: no

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.

Campo obbligatorio: no

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

Campo obbligatorio: no

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

Campo obbligatorio: no

State

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

Tipo: string

Campo obbligatorio: no

StateTransitionReason

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

Tipo: string

Campo obbligatorio: no

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\-_.]+)

Campo obbligatorio: no

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.

Campo obbligatorio: no

UUID

L'identificatore della mappatura dell'origine eventi.

Tipo: string

Campo obbligatorio: no

Vedi anche

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

• SDK AWS per C++

• SDK AWS per Go

• SDK AWS per Java V2

• SDK AWS per Ruby V3