Utilisation de l’objet de contexte Lambda pour récupérer les informations de la fonction Node.js - 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.

Utilisation de l’objet de contexte Lambda pour récupérer les informations de la fonction Node.js

Lorsque Lambda exécute votre fonction, il transmet un objet contexte au gestionnaire. Cet objet fournit des méthodes et des propriétés fournissant des informations sur l’invocation, la fonction et l’environnement d’exécution.

Méthodes de contexte

  • getRemainingTimeInMillis() – Renvoie le nombre de millisecondes restant avant l’expiration de l’exécution.

Propriétés du contexte

  • functionName – Nom de la fonction Lambda.

  • functionVersion – Version de la fonction.

  • invokedFunctionArn – Amazon Resource Name (ARN) utilisé pour appeler la fonction. Indique si l’appelant a spécifié un numéro de version ou un alias.

  • memoryLimitInMB – Quantité de mémoire allouée à la fonction.

  • awsRequestId – Identifiant de la demande d’invocation.

  • logGroupName – Groupe de journaux pour la fonction.

  • logStreamName – Flux de journal de l’instance de fonction.

  • identity – (applications mobiles) Informations sur l’identité Amazon Cognito qui a autorisé la demande.

    • cognitoIdentityId – Identité Amazon Cognito authentifiée.

    • cognitoIdentityPoolId – Groupe d’identités Amazon Cognito ayant autorisé l’invocation.

  • clientContext – (applications mobiles) Contexte client fourni à Lambda par l’application client.

    • client.installation_id

    • client.app_title

    • client.app_version_name

    • client.app_version_code

    • client.app_package_name

    • env.platform_version

    • env.platform

    • env.make

    • env.model

    • env.locale

    • custom – Personnalisez les valeurs qui sont définies par l’application client.

  • callbackWaitsForEmptyEventLoop— Par défaut (true), lors de l'utilisation d'un gestionnaire de fonctions basé sur le rappel, Lambda attend que la boucle d'événements soit vide après l'exécution du rappel avant de mettre fin à l'appel de la fonction. Définissez cette valeur false sur pour envoyer la réponse et mettre fin à l'appel immédiatement après l'exécution du rappel au lieu d'attendre que la boucle d'événements soit vide. Les événements exceptionnels continuent de se dérouler lors de la prochaine invocation. Notez que Lambda prend en charge les gestionnaires de fonctions basés sur le rappel pour les environnements d'exécution de Node.js 22 et antérieurs uniquement.

Dans l'exemple suivant, la fonction enregistre des informations de contexte et renvoie l'emplacement des journaux.

Exemple Fichier index.js
exports.handler = async function(event, context) {
  console.log('Remaining time: ', context.getRemainingTimeInMillis())
  console.log('Function name: ', context.functionName)
  return context.logStreamName
}