GetFunctionEventInvokeConfig - AWS Lambda

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.

GetFunctionEventInvokeConfig

Récupère 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

GET /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1

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 fonctionmy-function (name-only), my-function:v1 (avec alias).

  • ARN de fonctionarn:aws:lambda:us-west-2:123456789012:function:my-function.

  • ARN partiel123456789012: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

La demande n’a pas de corps de requête.

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

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 :