Utilisation de l'objet de contexte Lambda pour récupérer les informations relatives aux fonctions 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.

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— Le nom de ressource Amazon (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 Node.js soit vide. Si ce paramètre est faux, les événements restants continueront de s'exécuter lors de la prochaine invocation.

Vous pouvez utiliser le package npm @types/aws-lambda pour travailler avec l'objet de contexte.

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. Quand @types/aws-lambda est installé, l'instruction import (import ... from 'aws-lambda') importe les définitions de type. Il n'importe pas le aws-lambda NPM package, qui est un outil tiers indépendant. Pour plus d'informations, consultez aws-lambda dans le référentiel. DefinitelyTyped GitHub

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;
};