Appel synchrone

Lorsque vous appelez une fonction de façon synchrone, Lambda l'exécute et attend une réponse. Une fois l'exécution de la fonction terminée, Lambda renvoie la réponse du code de la fonction avec des données supplémentaires, telles que la version de la fonction qui a été appelée. Pour appeler une fonction de façon synchrone avec AWS CLI, utilisez la commande invoke.

aws lambda invoke --function-name my-function --cli-binary-format raw-in-base64-out --payload '{ "key": "value" }' response.json

L'option cli-binary-format est obligatoire si vous utilisez AWS CLI version 2. Pour faire de ce paramètre le paramètre par défaut, exécutez aws configure set cli-binary-format raw-in-base64-out. Pour plus d'informations, veuillez consulter les AWS CLI options de ligne de commande.

Vous devriez voir la sortie suivante :

{
    "ExecutedVersion": "$LATEST",
    "StatusCode": 200
}

Le diagramme suivant montre des clients appelant une fonction Lambda de manière synchrone. Lambda envoie les événements directement à la fonction et renvoie la réponse de la fonction à l'appelant.

payload est une chaîne qui contient un événement au format JSON. Le nom du fichier où l'AWS CLI écrit la réponse de la fonction est response.json. Si la fonction renvoie un objet ou une erreur, la réponse est l'objet ou d'une erreur au format JSON. Si la fonction se termine sans erreur, la réponse est null.

La sortie de la commande qui s'affiche dans le terminal inclut des informations extraites d'en-têtes figurant dans la réponse de Lambda. Ces informations incluent la version qui a traité l'événement (utile lorsque vous utilisez des alias) et le code d’état renvoyé par Lambda. Si Lambda a pu exécuter la fonction, le code d'état est 200, même si la fonction a renvoyé une erreur.

Note

Pour les fonctions avec un long délai d'attente, votre client peut être déconnecté pendant l'appel synchrone, pendant qu'il attend une réponse. Configurez votre client HTTP, SDK, pare-feu, proxy ou système d'exploitation pour permettre des connexions longues avec des paramètres de délai d'attente ou de keep-alive.

Si Lambda n'a pas pu exécuter la fonction, l'erreur s'affiche dans la sortie.

aws lambda invoke --function-name my-function --cli-binary-format raw-in-base64-out --payload value response.json

Vous devriez voir la sortie suivante:

An error occurred (InvalidRequestContentException) when calling the Invoke operation: Could not parse request body into json: Unrecognized token 'value': was expecting ('true', 'false' or 'null')
 at [Source: (byte[])"value"; line: 1, column: 11]

La AWS CLI est un outil open-source qui vous permet d'interagir avec des services AWS à l'aide des commandes de votre shell de ligne de commande. Pour exécuter la procédure indiquée dans cette section, vous devez satisfaire aux exigences suivantes :

• AWS CLI – Installer la version 2

• AWS CLI – Configuration rapide avec aws configure

Vous pouvez utiliser AWS CLI pour récupérer les journaux d'un appel à l'aide de l'option de commande --log-type. La réponse inclut un champ LogResult qui contient jusqu'à 4 Ko de journaux codés en base64 provenant de l'appel.

Exemple récupérer un ID de journal

L'exemple suivant montre comment récupérer un ID de journal à partir du champ LogResult d'une fonction nommée my-function.

aws lambda invoke --function-name my-function out --log-type Tail

Vous devriez voir la sortie suivante:

{
    "StatusCode": 200,
    "LogResult": "U1RBUlQgUmVxdWVzdElkOiA4N2QwNDRiOC1mMTU0LTExZTgtOGNkYS0yOTc0YzVlNGZiMjEgVmVyc2lvb...",
    "ExecutedVersion": "$LATEST"
}

Exemple décoder les journaux

Dans la même invite de commandes, utilisez l'utilitaire base64 pour décoder les journaux. L'exemple suivant montre comment récupérer les journaux encodés en base64 pour my-function.

aws lambda invoke --function-name my-function out --log-type Tail \
--query 'LogResult' --output text |  base64 -d

Vous devriez voir la sortie suivante:

START RequestId: 57f231fb-1730-4395-85cb-4f71bd2b87b8 Version: $LATEST
"AWS_SESSION_TOKEN": "AgoJb3JpZ2luX2VjELj...", "_X_AMZN_TRACE_ID": "Root=1-5d02e5ca-f5792818b6fe8368e5b51d50;Parent=191db58857df8395;Sampled=0"",ask/lib:/opt/lib",
END RequestId: 57f231fb-1730-4395-85cb-4f71bd2b87b8
REPORT RequestId: 57f231fb-1730-4395-85cb-4f71bd2b87b8  Duration: 79.67 ms      Billed Duration: 80 ms         Memory Size: 128 MB     Max Memory Used: 73 MB

L'utilitaire base64 est disponible sous Linux, macOS et Ubuntu sous Windows. Les utilisateurs de macOS auront peut-être besoin d'utiliser base64 -D.

Pour plus d'informations sur l'API Invoke et la liste complète des paramètres, en-têtes et erreurs, consultez Appeler.

Lorsque vous appelez une fonction directement, vous pouvez vérifier la réponse pour les erreurs et réessayer. AWS CLI et le kit SDK AWS effectuent automatiquement de nouvelles tentatives selon les délais d'expiration du client, les limitations et les erreurs de service. Pour de plus amples informations, veuillez consulter Gestion des erreurs et tentatives automatiques dans AWS Lambda.