Utilisation de l’objet de contexte Lambda pour récupérer les informations de la fonction TypeScript - AWS Lambda

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

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.

Pour activer la vérification de type pour l’objet de contexte, vous devez ajouter le package @types/aws-lambda en tant que dépendance de développement et importer le type Context. Pour de plus amples informations, consultez Définitions de type pour Lambda.

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 : définissez ce paramètre sur faux pour envoyer la réponse dès que le rappel s’exécute, au lieu d’attendre que la boucle d’événement soit vide. Si ce paramètre est faux, les événements restants continueront de s’exécuter lors de la prochaine invocation.

Exemple Fichier index.ts

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

Note

Avant d’utiliser ce code dans une fonction Lambda, vous devez ajouter le package @types/aws-lambda en tant que dépendance de développement. Ce package contient les définitions de type pour Lambda. Pour de plus amples informations, consultez Définitions de type pour Lambda.

import { Context } from 'aws-lambda';
export const lambdaHandler = async (event: string, context: Context): Promise<string> => {
  console.log('Remaining time: ', context.getRemainingTimeInMillis());
  console.log('Function name: ', context.functionName);
  return context.logStreamName;
};