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.
UpdateFunctionEventInvokeConfig
Met à jour la configuration d’invocation asynchrone pour une fonction, une version ou un alias.
Pour configurer les options pour l’invocation asynchrone, utilisez PutFunctionEventInvokeConfig.
Syntaxe de la demande
POST /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json
{
"DestinationConfig": {
"OnFailure": {
"Destination": "string"
},
"OnSuccess": {
"Destination": "string"
}
},
"MaximumEventAgeInSeconds": number,
"MaximumRetryAttempts": number
}Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- FunctionName
-
Nom de l’alias, de la version ou de la fonction Lambda.
Formats de nom
-
Nom de la fonction –
my-function(name-only),my-function:v1(avec alias). -
ARN de fonction –
arn:aws:lambda:us-west-2:123456789012:function:my-function. -
ARN partiel –
123456789012:function:my-function.
Vous pouvez ajouter un numéro de version ou un alias à l’un des formats. 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.
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 : oui
-
- Qualifier
-
Numéro de version ou nom d’alias.
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 128.
Modèle :
(|[a-zA-Z0-9$_-]+)
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- DestinationConfig
-
Destination pour les événements après qu’ils ont été envoyés à une fonction pour traitement.
Destinations
-
Fonction - Amazon Resource Name (ARN) de la fonction Lambda.
-
File d’attente : l’ARN d’une file d’attente SQS standard.
-
Rubrique : l’ARN d’une rubrique SNS standard.
-
Bus d'événements : ARN d'un bus d' EventBridge événements Amazon.
Type : objet DestinationConfig
Obligatoire : non
-
- MaximumEventAgeInSeconds
-
Âge maximum d’une demande que Lambda envoie à une fonction pour traitement.
Type : entier
Plage valide : Valeur minimum de 60. Valeur maximum de 21 600.
Obligatoire : non
- MaximumRetryAttempts
-
Nombre maximum de tentatives autorisées lorsque la fonction renvoie une erreur.
Type : entier
Plage valide : Valeur minimum de 0. Valeur maximum de 2.
Obligatoire : non
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"DestinationConfig": {
"OnFailure": {
"Destination": "string"
},
"OnSuccess": {
"Destination": "string"
}
},
"FunctionArn": "string",
"LastModified": number,
"MaximumEventAgeInSeconds": number,
"MaximumRetryAttempts": number
}Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
- DestinationConfig
-
Destination pour les événements après qu’ils ont été envoyés à une fonction pour traitement.
Destinations
-
Fonction - Amazon Resource Name (ARN) de la fonction Lambda.
-
File d’attente : l’ARN d’une file d’attente SQS standard.
-
Rubrique : l’ARN d’une rubrique SNS standard.
-
Bus d'événements : ARN d'un bus d' EventBridge événements Amazon.
Type : objet DestinationConfig
-
- FunctionArn
-
ARN (Amazon Resource Name) de la fonction.
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-_]+))? - LastModified
-
Date et heure de dernière mise à jour de la configuration, exprimée en secondes au format horaire Unix.
Type : Timestamp
- MaximumEventAgeInSeconds
-
Âge maximum d’une demande que Lambda envoie à une fonction pour traitement.
Type : entier
Plage valide : Valeur minimum de 60. Valeur maximum de 21 600.
- MaximumRetryAttempts
-
Nombre maximum de tentatives autorisées lorsque la fonction renvoie une erreur.
Type : entier
Plage valide : Valeur minimum de 0. Valeur maximum de 2.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- 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
- 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.
Code d’état HTTP : 429
consultez aussi
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 :
