

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# UpdateEventSourceMapping
<a name="API_UpdateEventSourceMapping"></a>

Met à jour un mappage de source d’événement. Vous pouvez modifier la fonction invoquée par AWS Lambda ou suspendre l’invocation et le reprendre plus tard au même emplacement.

Pour en savoir plus sur la procédure à suivre pour configurer différentes sources d’événements, consultez les rubriques suivantes. 
+  [ Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-dynamodb-eventsourcemapping) 
+  [ Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-eventsourcemapping) 
+  [ Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-eventsource) 
+  [ Amazon MQ and RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-eventsourcemapping) 
+  [ Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html) 
+  [ Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/kafka-smaa.html) 
+  [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) 

Les options de gestion des erreurs suivantes ne sont disponibles que pour les sources de flux (DynamoDB et Kinesis) :
+  `BisectBatchOnFunctionError` – Si la fonction renvoie une erreur, fractionner le lot en deux, puis réessayer.
+  `DestinationConfig` – Envoyer les enregistrements ignorés à une file d’attente Amazon SQS ou à une rubrique Amazon SNS.
+  `MaximumRecordAgeInSeconds` – Ignorer les enregistrements plus anciens que l’âge spécifié. La valeur par défaut est infinie (-1). Lorsque la valeur est infinie (-1), les enregistrements qui ont échoué sont réessayés jusqu’à ce que l’enregistrement expire.
+  `MaximumRetryAttempts` – Ignorer les enregistrements après le nombre spécifié de tentatives. La valeur par défaut est infinie (-1). Lorsque la valeur est infinie (-1), les enregistrements ayant échoué sont réessayés jusqu’à ce que l’enregistrement expire.
+  `ParallelizationFactor` – Traiter simultanément plusieurs lots de chaque partition.

Pour en savoir plus sur les paramètres de configuration qui s’appliquent à chaque source d’événements, consultez les rubriques suivantes.
+  [ Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-params) 
+  [ Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-params) 
+  [ Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-params) 
+  [ Amazon MQ and RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-params) 
+  [ Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-parms) 
+  [ Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-kafka-parms) 
+  [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html#docdb-configuration) 

## Syntaxe de la demande
<a name="API_UpdateEventSourceMapping_RequestSyntax"></a>

```
PUT /2015-03-31/event-source-mappings/UUID HTTP/1.1
Content-type: application/json

{
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "Enabled": boolean,
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FunctionName": "string",
   "FunctionResponseTypes": [ "string" ],
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "ParallelizationFactor": number,
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "TumblingWindowInSeconds": number
}
```

## Paramètres de demande URI
<a name="API_UpdateEventSourceMapping_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [UUID](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-UUID"></a>
Identifiant du mappage de source d’événement.  
Obligatoire : oui

## Corps de la demande
<a name="API_UpdateEventSourceMapping_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [BatchSize](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-BatchSize"></a>
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).  
+  **Amazon Kinesis** – La valeur par défaut est 100. Valeur maximum, 10 000.
+  **Amazon DynamoDB Streams** – La valeur par défaut est 100. Valeur maximum, 10 000.
+  **Amazon Simple Queue Service** – La valeur par défaut est 10. Pour les files d’attente standard, le maximum est de 10 000. Pour les files d’attente FIFO, le maximum est de 10.
+  **Amazon Managed Streaming for Apache Kafka** – La valeur par défaut est 100. Valeur maximum, 10 000.
+  **Apache Kafka Autogéré** – La valeur par défaut est 100. Valeur maximum, 10 000.
+  **Amazon MQ (ActiveMQ et RabbitMQ)** – La valeur par défaut est 100. Valeur maximum, 10 000.
+  **DocumentDB** – Valeur par défaut 100. Valeur maximum, 10 000.
Type : entier  
Plage valide : Valeur minimum de 1. Valeur maximum de 10 000.  
Obligatoire : non

 ** [BisectBatchOnFunctionError](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-BisectBatchOnFunctionError"></a>
(Flux Kinesis et DynamoDB uniquement) Si la fonction renvoie une erreur, partagez le lot en deux et recommencez.  
Type : booléen  
Obligatoire : non

 ** [DestinationConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-DestinationConfig"></a>
(Kinesis, DynamoDB Streams, Amazon MSK et Kafka autogéré uniquement) Objet de configuration qui spécifie la destination d’un événement après son traitement par Lambda.  
Type : objet [DestinationConfig](API_DestinationConfig.md)  
Obligatoire : non

 ** [DocumentDBEventSourceConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-DocumentDBEventSourceConfig"></a>
Paramètres de configuration spécifiques pour une source d’événement DocumentDB.  
Type : objet [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md)  
Obligatoire : non

 ** [Enabled](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-Enabled"></a>
Si la valeur est sur VRAI, le mappage de source d’événement est actif. Si la valeur est sur FAUX, Lambda interrompt l’interrogation et l’invocation.  
Valeur par défaut : VRAI  
Type : booléen  
Obligatoire : non

 ** [FilterCriteria](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-FilterCriteria"></a>
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](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
Type : objet [FilterCriteria](API_FilterCriteria.md)  
Obligatoire : non

 ** [FunctionName](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-FunctionName"></a>
Nom de la fonction Lambda.  

**Formats de nom**
+  **Nom de fonction** – `MyFunction`.
+  **ARN de fonction** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
+  **ARN de version ou d’alias** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD`.
+  **ARN partiel** – `123456789012:function:MyFunction`.
Contrainte de longueur qui s’applique uniquement à l’ARN complet. Si vous spécifiez uniquement le nom de la fonction, ce dernier est limité à 64 caractères.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 140.  
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-_]+))?`   
Obligatoire : non

 ** [FunctionResponseTypes](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-FunctionResponseTypes"></a>
(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`   
Obligatoire : non

 ** [MaximumBatchingWindowInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumBatchingWindowInSeconds"></a>
L’intervalle de temps maximal (en secondes) 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.  
Obligatoire : non

 ** [MaximumRecordAgeInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumRecordAgeInSeconds"></a>
(Flux Kinesis et DynamoDB uniquement) Ignore les enregistrements plus anciens que l’âge spécifié. La valeur par défaut est infinie (-1).  
Type : entier  
Plage valide : Valeur minimum de -1. Valeur maximum de 604 800.  
Obligatoire : non

 ** [MaximumRetryAttempts](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumRetryAttempts"></a>
(Flux Kinesis et DynamoDB uniquement) Ignore les enregistrements après le nombre de tentatives spécifié. La valeur par défaut est infinie (-1). Lorsque la valeur est infinie (-1), les enregistrements ayant échoué sont réessayés jusqu’à ce que l’enregistrement expire.  
Type : entier  
Plage valide : Valeur minimum de -1. Valeur maximum de 10 000.  
Obligatoire : non

 ** [ParallelizationFactor](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-ParallelizationFactor"></a>
(Flux Kinesis et DynamoDB uniquement) Nombre de lots à traiter simultanément à partir de chaque partition.  
Type : entier  
Plage valide : Valeur minimum de 1. Valeur maximum de 10.  
Obligatoire : non

 ** [ScalingConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-ScalingConfig"></a>
(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](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency).  
Type : objet [ScalingConfig](API_ScalingConfig.md)  
Obligatoire : non

 ** [SourceAccessConfigurations](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-SourceAccessConfigurations"></a>
Tableau des protocoles d’authentification ou des composants VPC requis pour sécuriser votre source d’événement.  
Type : tableau d’objets [SourceAccessConfiguration](API_SourceAccessConfiguration.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 22 éléments.  
Obligatoire : non

 ** [TumblingWindowInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-TumblingWindowInSeconds"></a>
(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.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_UpdateEventSourceMapping_ResponseSyntax"></a>

```
HTTP/1.1 202
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"
}
```

## Eléments de réponse
<a name="API_UpdateEventSourceMapping_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 202.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [AmazonManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Paramètres de configuration spécifiques pour une source d’événements Amazon Managed Streaming for Apache Kafka (Amazon MSK).  
Type : objet [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md)

 ** [BatchSize](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-BatchSize"></a>
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.

 ** [BisectBatchOnFunctionError](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(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

 ** [DestinationConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-DestinationConfig"></a>
(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](API_DestinationConfig.md)

 ** [DocumentDBEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
Paramètres de configuration spécifiques pour une source d’événement DocumentDB.  
Type : objet [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md)

 ** [EventSourceArn](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-EventSourceArn"></a>
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})?:(.*)` 

 ** [FilterCriteria](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FilterCriteria"></a>
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](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
Type : objet [FilterCriteria](API_FilterCriteria.md)

 ** [FunctionArn](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FunctionArn"></a>
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-_]+))?` 

 ** [FunctionResponseTypes](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FunctionResponseTypes"></a>
(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` 

 ** [LastModified](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-LastModified"></a>
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

 ** [LastProcessingResult](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-LastProcessingResult"></a>
Résultat de la dernière invocation Lambda de votre fonction.  
Type : chaîne

 ** [MaximumBatchingWindowInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
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.

 ** [MaximumRecordAgeInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(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.  
La valeur minimale valide pour l’âge maximal de l’enregistrement est 60 secondes. Bien que les valeurs inférieures à 60 et supérieures à -1 se situent dans la plage absolue du paramètre, elles ne sont pas autorisées
Type : entier  
Plage valide : Valeur minimum de -1. Valeur maximum de 604 800.

 ** [MaximumRetryAttempts](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumRetryAttempts"></a>
(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.

 ** [ParallelizationFactor](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-ParallelizationFactor"></a>
(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.

 ** [Queues](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-Queues"></a>
 (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]*` 

 ** [ScalingConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-ScalingConfig"></a>
(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](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency).  
Type : objet [ScalingConfig](API_ScalingConfig.md)

 ** [SelfManagedEventSource](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-SelfManagedEventSource"></a>
Cluster Apache Kafka autogéré pour votre source d’événement.  
Type : objet [SelfManagedEventSource](API_SelfManagedEventSource.md)

 ** [SelfManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
Paramètres de configuration spécifiques pour une source d’événement Apache Kafka autogérée.  
Type : objet [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md)

 ** [SourceAccessConfigurations](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-SourceAccessConfigurations"></a>
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](API_SourceAccessConfiguration.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 22 éléments.

 ** [StartingPosition](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StartingPosition"></a>
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` 

 ** [StartingPositionTimestamp](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StartingPositionTimestamp"></a>
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

 ** [State](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-State"></a>
État du mappage de source d’événement. Peut être `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating` ou `Deleting`.  
Type : chaîne

 ** [StateTransitionReason](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StateTransitionReason"></a>
Indique si un utilisateur ou Lambda a apporté la dernière modification au mappage de source d’événement.  
Type : chaîne

 ** [Topics](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-Topics"></a>
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\-_.]+)` 

 ** [TumblingWindowInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-TumblingWindowInSeconds"></a>
(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.

 ** [UUID](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-UUID"></a>
Identifiant du mappage de source d’événement.  
Type : chaîne

## Erreurs
<a name="API_UpdateEventSourceMapping_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** InvalidParameterValueException **   
L’un des paramètres dans la demande n’est pas valide.  
Code d’état HTTP : 400

 ** ResourceConflictException **   
La ressource existe déjà ou une autre opération est en cours.  
Code d’état HTTP : 409

 ** ResourceInUseException **   
L’opération est en conflit avec la disponibilité de la ressource. Par exemple, vous avez essayé de mettre à jour un mappage des sources d’événements dans l’état CREATING, ou vous avez essayé de supprimer un mappage des sources d’événements actuellement dans l’état UPDATING.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
La ressource spécifiée dans la demande n’existe pas.  
Code d’état HTTP : 404

 ** ServiceException **   
Le service AWS Lambda a rencontré une erreur interne.  
Code d’état HTTP : 500

 ** TooManyRequestsException **   
La limite de débit de demande a été dépassée. Pour plus d’informations, consultez [Quotas Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Code d’état HTTP : 429

## consultez aussi
<a name="API_UpdateEventSourceMapping_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWSSDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [Kit AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [Kit AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateEventSourceMapping) 