Invoquer une fonction Lambda de manière synchrone

Lorsque vous invoquez 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é invoquée. Pour appeler une fonction de manière synchrone avec le AWS CLI, utilisez la invoke commande.

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

L'cli-binary-formatoption est obligatoire si vous utilisez AWS CLI la 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, consultez les options de ligne de commande globales AWS CLI prises en charge dans le Guide de l’utilisateur AWS Command Line Interface version 2.

Vous devriez voir la sortie suivante :

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

Le diagramme suivant montre des clients invoquant 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.

payloadIl s'agit d'une chaîne qui contient un événement au JSON format. 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, le corps de la réponse est l'objet ou l'erreur de JSON format. Si la fonction s'arrête sans erreur, le corps de la réponse estnull.

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.

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]

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

Vous pouvez utiliser AWS CLI pour récupérer les journaux d’une invocation à 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’invocation.

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

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

aws lambda invoke --function-name my-function out --log-type Tail \
--query 'LogResult' --output text --cli-binary-format raw-in-base64-out | base64 --decode

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

Pour plus d'informations sur le InvokeAPI, y compris une liste complète des paramètres, des en-têtes et des erreurs, consultez Invoke.

Lorsque vous invoquez une fonction directement, vous pouvez vérifier la réponse pour les erreurs et réessayer. Ils AWS CLI peuvent AWS SDK également réessayer automatiquement en cas d'expiration des délais, de limitation et d'erreurs de service du client. Pour de plus amples informations, veuillez consulter Comprendre le comportement des nouvelles tentatives dans Lambda.