Utilizzo dell'oggetto di contesto Lambda per recuperare le informazioni sulla funzione Node.js

Quando Lambda esegue la funzione, passa un oggetto Context al gestore. Questo oggetto fornisce i metodi e le proprietà che forniscono le informazioni sulla chiamata, sulla funzione e sull'ambiente di esecuzione.

Metodi del contesto

• getRemainingTimeInMillis(): restituisce il numero di millisecondi rimasti prima del timeout dell'esecuzione.

Proprietà del contesto

• functionName: il nome della funzione Lambda.

• functionVersion: la versione della funzione.

• invokedFunctionArn: l'Amazon Resource Name (ARN) utilizzato per richiamare la funzione. Indica se l'invoker ha specificato un numero di versione o un alias.

• memoryLimitInMB: la quantità di memoria allocata per la funzione.

• awsRequestId: l'identificatore della richiesta di invocazione.

• logGroupName: il gruppo di log per la funzione.

• logStreamName: il flusso di log per l'istanza della funzione.

• identity: (app per dispositivi mobili) Informazioni relative all'identità Amazon Cognito che ha autorizzato la richiesta.

  • cognitoIdentityId: l'identità autenticata di Amazon Cognito.

  • cognitoIdentityPoolId: il pool di identità Amazon Cognito che ha autorizzato l'invocazione.

• clientContext: (app per dispositivi mobili) Contesto client fornito a Lambda dall'applicazione 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: valori personalizzati impostati dall'applicazione mobile.

• callbackWaitsForEmptyEventLoop— Per impostazione predefinita (true), quando si utilizza un gestore di funzioni basato sul callback, Lambda attende che il ciclo di eventi sia vuoto dopo l'esecuzione del callback prima di terminare l'invoca della funzione. Imposta su false per inviare la risposta e terminare la chiamata immediatamente dopo l'esecuzione del callback anziché attendere che il ciclo di eventi sia vuoto. Gli eventi eccezionali continuano a verificarsi durante la chiamata successiva. Nota che Lambda supporta gestori di funzioni basati su callback solo per Node.js 22 e runtime precedenti.

La seguente funzione di esempio registra le informazioni di contesto e restituisce la posizione dei log.

Esempio File index.js

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