GetEventSourceMapping

Identifiant du mappage de source d’événement.

Obligatoire : oui

Paramètres de configuration spécifiques pour une source d’événements Amazon Managed Streaming for Apache Kafka (Amazon MSK).

Type : objet AmazonManagedKafkaEventSourceConfig

Nombre maximal d’enregistrements dans chaque lot que Lambda extrait de votre flux ou file d’attente et envoie à votre fonction. Lambda transmet tous les enregistrements du lot à la fonction en un seul appel, dans la limite de charge utile pour une invocation synchrone (6 Mo).

Valeur par défaut : varie selon le service. Pour Amazon SQS, la valeur par défaut est 10. Pour tous les autres services, la valeur par défaut est 100.

Paramètre associé : lorsque vous définissez BatchSize sur une valeur supérieure à 10, vous devez définir MaximumBatchingWindowInSeconds sur une valeur égale ou supérieure à 1.

Type : entier

Plage valide : Valeur minimum de 1. Valeur maximum de 10 000.

(Flux Kinesis et DynamoDB uniquement) Si la fonction renvoie une erreur, partagez le lot en deux et recommencez. La valeur par défaut est false.

Type : booléen

(Kinesis, DynamoDB Streams, Amazon MSK et sources d'événements Apache Kafka autogérées uniquement) Objet de configuration qui spécifie la destination d'un événement une fois que Lambda l'a traité.

Type : objet DestinationConfig

Paramètres de configuration spécifiques pour une source d’événement DocumentDB.

Type : objet DocumentDBEventSourceConfig

Amazon Resource Name (ARN) de la source d’événement.

Type : chaîne

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

Un objet qui définit les critères permettant de déterminer si Lambda doit traiter un événement. Pour plus d’informations, consultez la section Filtrage des événements Lambda.

Type : objet FilterCriteria

ARN de la fonction Lambda.

Type : chaîne

Modèle : 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-_]+))?

(Flux Kinesis, DynamoDB et Amazon SQS) Liste des énumérations de type de réponse en cours appliquées au mappage des sources d’événements.

Type : tableau de chaînes

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément.

Valeurs valides : ReportBatchItemFailures

Date à laquelle le mappage de source d’événement a été mis à jour ou a changé d’état pour la dernière fois, exprimée en secondes au format horaire Unix.

Type : horodatage

Résultat de la dernière invocation Lambda de votre fonction.

Type : chaîne

L’intervalle de temps maximal (en secondes) que prend Lambda pour collecter des enregistrements avant d’invoquer la fonction. Vous pouvez configurer MaximumBatchingWindowInSeconds à n’importe quelle valeur comprise entre 0 et 300 secondes par incréments de secondes.

Pour les flux et les sources d’événements Amazon SQS : la fenêtre de traitement par lot par défaut est de 0 seconde. Pour les sources d’événements Amazon MSK, Apache Kafka autogérées, Amazon MQ et DocumentDB : la fenêtre de traitement par lots par défaut est de 500 ms. Parce que vous ne pouvez que changer MaximumBatchingWindowInSeconds par incréments de secondes, vous ne pouvez pas revenir à la fenêtre de traitement par lots par défaut de 500 ms après l’avoir modifiée. Pour restaurer la fenêtre de traitement par lots par défaut, vous devez créer un mappage de source d’événement.

Paramètre associé : Pour les flux et les sources d’événements Amazon SQS, lorsque vous définissez BatchSize sur une valeur supérieure à 10, vous devez définir MaximumBatchingWindowInSeconds sur une valeur égale ou supérieure à 1.

Type : entier

Plage valide : Valeur minimum de 0. Valeur maximum de 300.

(Flux Kinesis et DynamoDB uniquement) Ignore les enregistrements plus anciens que l’âge spécifié. La valeur par défaut est -1, qui définit l’âge maximum sur infini. Lorsque la valeur est définie sur infini, Lambda ne supprime jamais les anciens enregistrements.

Type : entier

Plage valide : Valeur minimum de -1. Valeur maximum de 604 800.

(Flux Kinesis et DynamoDB uniquement) Ignore les enregistrements après le nombre de tentatives spécifié. La valeur par défaut est -1, qui définit le nombre maximum de nouvelles tentatives sur infini. Lorsqu'il MaximumRetryAttempts est infini, Lambda réessaie les enregistrements ayant échoué jusqu'à ce que l'enregistrement expire dans la source d'événements.

Type : entier

Plage valide : Valeur minimum de -1. Valeur maximum de 10 000.

(Flux Kinesis et DynamoDB uniquement) Nombre de lots de chaque partition à traiter simultanément. La valeur par défaut est 1.

Type : entier

Plage valide : Valeur minimum de 1. Valeur maximum de 10.

(Amazon MQ) Nom de la file d’attente de destination de l’agent Amazon MQ à consommer.

Type : tableau de chaînes

Membres du tableau : nombre fixe de 1 élément.

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1 000.

Modèle : [\s\S]*

(Amazon SQS uniquement) Configuration de dimensionnement pour la source de l’événement. Pour plus d’informations, consultez Configuration de la simultanéité maximale pour les sources d’événements Amazon SQS.

Type : objet ScalingConfig

Cluster Apache Kafka autogéré pour votre source d’événement.

Type : objet SelfManagedEventSource

Paramètres de configuration spécifiques pour une source d’événement Apache Kafka autogérée.

Type : objet SelfManagedKafkaEventSourceConfig

Tableau du protocole d’authentification, composants VPC ou hôte virtuel pour sécuriser et définir votre source d’événement.

Type : tableau d’objets SourceAccessConfiguration

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 22 éléments.

Position de début de la lecture dans le flux. Obligatoire pour les sources d’événements Amazon Kinesis et Amazon DynamoDB Stream. AT_TIMESTAMP est pris en charge uniquement pour les flux Amazon Kinesis, Amazon DocumentDB, Amazon MSK et Apache Kafka autogéré.

Type : chaîne

Valeurs valides : TRIM_HORIZON | LATEST | AT_TIMESTAMP

Avec StartingPosition défini sur AT_TIMESTAMP, l’heure à partir de laquelle doit commencer la lecture, en secondes au format horaire Unix. StartingPositionTimestamp ne peut pas se situer dans le futur.

Type : Timestamp

État du mappage de source d’événement. Peut être Creating, Enabling, Enabled, Disabling, Disabled, Updating ou Deleting.

Type : chaîne

Indique si un utilisateur ou Lambda a apporté la dernière modification au mappage de source d’événement.

Type : chaîne

Nom de la rubrique Kafka.

Type : tableau de chaînes

Membres du tableau : nombre fixe de 1 élément.

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 249.

Modèle : ^[^.]([a-zA-Z0-9\-_.]+)

(Flux Kinesis et DynamoDB uniquement) Durée en secondes d’une fenêtre de traitement pour les sources d’événement des flux DynamoDB et Kinesis. Une valeur de 0 seconde indique qu’il n’y a pas de fenêtre à bascule.

Type : entier

Plage valide : Valeur minimum de 0. Valeur maximum de 900.

Identifiant du mappage de source d’événement.

Type : chaîne

L’un des paramètres dans la demande n’est pas valide.

Code d’état HTTP : 400

La ressource spécifiée dans la demande n’existe pas.

Code d’état HTTP : 404

Le service AWS Lambda a rencontré une erreur interne.

Code d’état HTTP : 500

La limite de débit de demande a été dépassée. Pour plus d’informations, consultez Quotas Lambda.

Code d’état HTTP : 429