Prerequisiti Creazione della funzione Invocazione della funzione Eliminazione Passaggi successivi

Crea la tua prima funzione Lambda

Per iniziare a utilizzare Lambda, usa la console Lambda per creare una funzione. In pochi minuti puoi creare e implementare una funzione, e testarla nella console.

Mano a mano che esegui il tutorial, apprenderai alcuni concetti fondamentali di Lambda, ad esempio come passare argomenti a una funzione tramite l'oggetto evento di Lambda. Apprenderai, inoltre, come restituire gli output del log da una funzione e come visualizzare i log di invocazione della funzione in log Amazon CloudWatch Logs.

A scopo di semplificazione, crea la funzione utilizzando il runtime Python o Node.js. Con questi linguaggi interpretati, puoi modificare il codice della funzione direttamente nell'editor del codice integrato della console. Con linguaggi compilati come Java e C#, devi creare un pacchetto di implementazione sulla macchina di compilazione locale e caricarlo su Lambda. Per informazioni sull'implementazione di funzioni in Lambda tramite altri runtime, consulta i link nella sezione Risorse aggiuntive e fasi successive.

Suggerimento

Per scoprire come creare soluzioni serverless, consulta la Guida allo sviluppo serverless.

Prerequisiti

Se non disponi di un Account AWS, completa le fasi seguenti per crearne uno.

Per registrarsi a un Account AWS

Apri la pagina all'indirizzo https://portal.aws.amazon.com/billing/signup.
Segui le istruzioni online.

Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono.

Durante la registrazione di un Account AWS, viene creato un Utente root dell'account AWS. L'utente root dispone dell'accesso a tutte le risorse e tutti i Servizi AWS nell'account. Come best practice di sicurezza, assegna l'accesso amministrativo a un utente e utilizza solo l'utente root per eseguire attività che richiedono l'accesso di un utente root.

AWSAl termine del processo di registrazione, riceverai un'e-mail di conferma da . È possibile visualizzare l'attività corrente dell'account e gestire l'account in qualsiasi momento accedendo all'indirizzo https://aws.amazon.com/ e selezionando Il mio account.

Dopo aver effettuato la registrazione di un Account AWS, proteggi Utente root dell'account AWS, abilita AWS IAM Identity Center e crea un utente amministratore in modo da non utilizzare l'utente root per le attività quotidiane.

Protezione dell'Utente root dell'account AWS

Accedi alla Console di gestione AWScome proprietario dell'account scegliendo Utente root e immettendo l'indirizzo email dell'Account AWS. Nella pagina successiva, inserisci la password.

Per informazioni sull'accesso utilizzando un utente root, consulta la pagina Signing in as the root user della Guida per l'utente di Accedi ad AWS.
Abilita l'autenticazione a più fattori (MFA) per l'utente root.

Per ricevere istruzioni, consulta Abilitare un dispositivo MFA virtuale per l'utente root della Account AWS (console) nella Guida per l'utente IAM.

Crea un utente con accesso amministrativo

Abilita Centro identità IAM.

Per istruzioni, consulta Abilitazione di AWS IAM Identity Center nella Guida per l'utente di AWS IAM Identity Center.
In IAM Identity Center, assegna l'accesso amministrativo a un utente.

Per un tutorial sull'utilizzo di IAM Identity Center directory come origine di identità, consulta Configurazione dell'accesso utente con IAM Identity Center directory predefinito nella Guida per l'utente di AWS IAM Identity Center.

Accesso come utente amministratore

Per accedere con l'utente IAM Identity Center, utilizza l'URL di accesso che è stato inviato al tuo indirizzo e-mail quando hai creato l'utente IAM Identity Center.

Per ricevere assistenza nell'accesso mediante un utente IAM Identity Center, consulta Accedere al portale di accesso AWSnella Guida per l'utente Accedi ad AWS.

Assegna l'accesso a ulteriori utenti

In IAM Identity Center, crea un set di autorizzazioni conforme alla best practice dell'applicazione di autorizzazioni con il privilegio minimo.

Segui le istruzioni riportate nella pagina Creazione di un set di autorizzazioni nella Guida per l'utente di AWS IAM Identity Center.
Assegna al gruppo prima gli utenti e poi l'accesso con autenticazione unica (Single Sign-On).

Per istruzioni, consulta Aggiungere gruppi nella Guida per l'utente di AWS IAM Identity Center.

Creare una funzione Lambda con la console

In questo esempio, la funzione acquisisce un oggetto JSON contenente due valori interi etichettati "length" e "width". La funzione moltiplica tali valori per calcolare un'area e la restituisce come stringa JSON.

La funzione, inoltre, stampa l'area calcolata assieme al nome del relativo gruppo di log CloudWatch. Più avanti nel tutorial, apprenderai l'uso dei log CloudWatch per visualizzare record di invocazione delle tue funzioni.

Per creare una funzione Lambda Hello world con la console

Aprire la pagina Funzioni della console Lambda.
Scegli Crea funzione.
Scegli Crea da zero.
Nel riquadro Informazioni base, per Nome funzione inserisci myLambdaFunction.
Per Runtime, scegli Node.js 22 o Python 3.13.
Lascia l'architettura impostata su x86_64 e scegli Crea funzione.

Oltre a una funzione semplice che restituisce il messaggio Hello from Lambda!, Lambda crea anche un ruolo di esecuzione per la tua funzione. Un ruolo di esecuzione è un ruolo AWS Identity and Access Management (IAM) che concede un'autorizzazione della funzione Lambda per l'accesso a Servizi AWS e risorse. Per la tua funzione, il ruolo creato da Lambda concede autorizzazioni di base per scrivere su log CloudWatch.

Utilizza l'editor di codice integrato della console per sostituire il codice Hello world creato da Lambda con il codice della tua funzione.

Node.js

Per modificare il codice nella console

Scegli la scheda Codice.

Nell'editor di codice integrato della console, dovresti vedere il codice della funzione creato da Lambda. Se non vedi la scheda index.js nell'editor di codice, seleziona index.js in Esplora file, come illustrato nel diagramma seguente.

Incolla il codice seguente nella scheda index.js, sostituendo il codice creato da Lambda.


export const handler = async (event, context) => {
  
  const length = event.length;
  const width = event.width;
  let area = calculateArea(length, width);
  console.log(`The area is ${area}`);
        
  console.log('CloudWatch log group: ', context.logGroupName);
  
  let data = {
    "area": area,
  };
    return JSON.stringify(data);
    
  function calculateArea(length, width) {
    return length * width;
  }
};

Nella sezione DEPLOY, scegli Implementa per aggiornare il codice della tua funzione:

Comprendere il codice della funzione

Prima di passare alla fase successiva, esaminiamo il codice della funzione e apprendiamo alcuni concetti chiave di Lambda.

Il gestore Lambda:

La tua funzione Lambda contiene una funzione Node.js denominata handler. Una funzione Lambda in Node.js può contenere più di una funzione Node.js, ma la funzione del gestore è sempre il punto di ingresso al codice. Quando viene richiamata la funzione, Lambda esegue questo metodo.

Una volta creata la funzione Hello world utilizzando la console, Lambda imposta automaticamente su handler il nome del metodo del gestore per la funzione. Non modificare il nome di questa funzione Node.js. Se modifichi il nome, Lambda non sarà in grado di eseguire il codice quando richiami la funzione.

Per ulteriori informazioni sul gestore Lambda in Node.js, consulta Definire l'handler delle funzioni Lambda in Node.js.
L'oggetto evento Lambda:

La funzione handler acquisisce due argomenti, event e context. Un evento in Lambda è un documento in formato JSON contenente i dati che la funzione deve elaborare.

Se la funzione è richiamata da un altro Servizio AWS, l'oggetto evento contiene informazioni sull'evento che ha causato l'invocazione. Ad esempio, se la funzione viene richiamata quando un oggetto viene caricato in un bucket Amazon Simple Storage Service (Amazon S3), l'evento conterrà il nome del bucket e la chiave dell'oggetto.

In questo esempio verrà creato un evento nella console inserendo un documento in formato JSON con due coppie chiave-valore.
L'oggetto contestuale Lambda:

Il secondo argomento acquisito dalla funzione è context. Lambda passa l'oggetto contestuale alla tua funzione automaticamente. L'oggetto contestuale contiene informazioni sull'invocazione della funzione e sull'ambiente di esecuzione.

Puoi utilizzare l'oggetto contestuale per generare informazioni sull'invocazione della funzione a scopo di monitoraggio. In questo esempio, la funzione utilizza il parametro logGroupName per visualizzare il nome del relativo gruppo di log CloudWatch.

Per ulteriori informazioni sull'oggetto contestuale Lambda in Node.js, consulta Utilizzo dell'oggetto di contesto Lambda per recuperare le informazioni sulla funzione Node.js.
Accesso a Lambda:

Con Node.js, puoi usare metodi della console come console.log e console.error per inviare informazioni al log della funzione. L'esempio di codice utilizza istruzioni console.log per fornire l'area calcolata e il nome del gruppo log CloudWatch della funzione. Puoi utilizzare anche qualunque libreria di log che scrive in stdout o stderr.

Per ulteriori informazioni, consulta Registrare e monitorare funzioni Lambda in Node.js. Per informazioni sui log in altri runtime, consulta le pagine “Creazione con” per i runtime a cui sei interessato.

Python

Per modificare il codice nella console

Scegli la scheda Codice.

Nell'editor di codice integrato della console, dovresti vedere il codice della funzione creato da Lambda. Se non vedi la scheda lambda_function.py nell'editor di codice, seleziona lambda_function.py in Esplora file, come illustrato nel diagramma seguente.

Incolla il codice seguente nella scheda lambda_function.py, sostituendo il codice creato da Lambda.


import json
import logging

logger = logging.getLogger()
logger.setLevel(logging.INFO)

def lambda_handler(event, context):
    
    # Get the length and width parameters from the event object. The 
    # runtime converts the event object to a Python dictionary
    length = event['length']
    width = event['width']
    
    area = calculate_area(length, width)
    print(f"The area is {area}")
        
    logger.info(f"CloudWatch logs group: {context.log_group_name}")
    
    # return the calculated area as a JSON string
    data = {"area": area}
    return json.dumps(data)
    
def calculate_area(length, width):
    return length*width

Nella sezione DEPLOY, scegli Implementa per aggiornare il codice della tua funzione:

Comprendere il codice della funzione

Prima di passare alla fase successiva, esaminiamo il codice della funzione e apprendiamo alcuni concetti chiave di Lambda.

Il gestore Lambda:

La funzione Lambda contiene una funzione Python denominata lambda_handler. Una funzione Lambda in Python può contenere più di una funzione Python, ma la funzione del gestore è sempre il punto di ingresso al codice. Quando viene richiamata la funzione, Lambda esegue questo metodo.

Una volta creata la funzione Hello world utilizzando la console, Lambda imposta automaticamente su lambda_handler il nome del metodo del gestore per la funzione. Non modificare il nome di questa funzione Python. Se modifichi il nome, Lambda non sarà in grado di eseguire il codice quando richiami la funzione.

Per ulteriori informazioni sul gestore Lambda in Python, consulta Definire l'handler della funzione Lambda in Python.
L'oggetto evento Lambda:

La funzione lambda_handler acquisisce due argomenti, event e context. Un evento in Lambda è un documento in formato JSON contenente i dati che la funzione deve elaborare.

Se la funzione è richiamata da un altro Servizio AWS, l'oggetto evento contiene informazioni sull'evento che ha causato l'invocazione. Ad esempio, se la funzione viene richiamata quando un oggetto viene caricato in un bucket Amazon Simple Storage Service (Amazon S3), l'evento conterrà il nome del bucket e la chiave dell'oggetto.

In questo esempio verrà creato un evento nella console inserendo un documento in formato JSON con due coppie chiave-valore.
L'oggetto contestuale Lambda:

Il secondo argomento acquisito dalla funzione è context. Lambda passa l'oggetto contestuale alla tua funzione automaticamente. L'oggetto contestuale contiene informazioni sull'invocazione della funzione e sull'ambiente di esecuzione.

Puoi utilizzare l'oggetto contestuale per generare informazioni sull'invocazione della funzione a scopo di monitoraggio. In questo esempio, la funzione utilizza il parametro log_group_name per visualizzare il nome del relativo gruppo di log CloudWatch.

Per ulteriori informazioni sull'oggetto contestuale Lambda in Python, consulta Utilizzo dell'oggetto del contesto Lambda per recuperare le informazioni sulla funzione Python.
Accesso a Lambda:

Con Python, puoi usare un'istruzione print o una libreria di log Python per inviare informazioni al log della funzione. Per illustrare la differenza tra i dati acquisiti, il codice di esempio utilizza entrambi i metodi. In un'applicazione in produzione, è preferibile utilizzare una libreria di log.

Per ulteriori informazioni, consulta Registrare e monitorare le funzioni Lambda con Python. Per informazioni sui log in altri runtime, consulta le pagine “Creazione con” per i runtime a cui sei interessato.

Richiamare la funzione Lambda tramite l'editor di codice della console

Per richiamare la funzione utilizzando l'editor di codice della console Lambda, devi prima creare un evento di test da inviare alla tua funzione. L'evento è un documento in formato JSON contenente due coppie chiave-valore con le chiavi "length" e "width".

Per creare un evento di test

Nella sezione TEST EVENTS dell'editor di codice della console, scegli Crea evento di test.
Per Event name (Nome evento), immettere myTestEvent.
Nella sezione JSON dell'evento, sostituisci il codice JSON predefinito con il seguente:
```
{
  "length": 6,
  "width": 7
}
```
Selezionare Salva.

Per testare la funzione e visualizzare i record di invocazione nella console

Nella sezione TEST EVENTS dell'editor di codice della console, scegli l'icona di esecuzione accanto all'evento di test:

Pulsante Esegui evento di test nell'editor di codice della console Lambda

Al termine dell'esecuzione della funzione, verranno visualizzati i log della risposta e della funzione nella scheda OUTPUT. Sono visualizzati risultati simili ai seguenti:

Quando richiami la tua funzione al di fuori della console Lambda, devi usare CloudWatch Logs per visualizzare i risultati di esecuzione della funzione.

Per visualizzare i record di invocazione della funzione in log CloudWatch

Aprire la pagina Log groups (Gruppi di log) nella console di Amazon CloudWatch.
Scegli il nome del gruppo di log per la funzione (/aws/lambda/myLambdaFunction). Questo è il nome del gruppo di log che la funzione ha stampato sulla console.

Scorri verso il basso e scegli il flusso di log per le invocazioni delle funzioni che desideri esaminare.

Elencare i flussi di log per una funzione Lambda.

Verrà visualizzato un output simile al seguente:

Eliminazione

Quando hai terminato il lavoro con la funzione di esempio, eliminala. Puoi anche eliminare il gruppo di log che memorizza i log della funzione e il ruolo di esecuzione creato dalla console.

Per eliminare la funzione Lambda

Aprire la pagina Functions (Funzioni) della console Lambda.
Selezionare la funzione creata.
Scegliere Operazioni, Elimina.
Inserisci confirm nel campo di immissione del testo, quindi scegli Elimina.

Come eliminare il gruppo di log

Aprire la pagina Log groups (Gruppi di log) nella console di Amazon CloudWatch.
Scegli il gruppo di log della funzione (/aws/lambda/myLambdaFunction).
Scegli Actions (Azioni), Delete log group(s) (Elimina gruppo/i di log).
Nella finestra di dialogo Delete log group(s) (Elimina gruppo/i di log) scegli Delete (Elimina).

Come eliminare il ruolo di esecuzione

Aprire la pagina Roles (Ruoli) della console IAM AWS Identity and Access Management.
Seleziona il ruolo di esecuzione della funzione (ad esempio, myLambdaFunction-role-31exxmpl).
Scegli Elimina.
Nella finestra di dialogo Elimina ruolo, immetti il nome del ruolo, quindi scegli Elimina.

Risorse aggiuntive e fasi successive

Una volta creata e testata una semplice funzione Lambda tramite la console, completa le seguenti fasi successive:

Scopri come aggiungere dipendenze alla tua funzione e implementala utilizzando un pacchetto di implementazione .zip. Scegli la lingua preferita dai seguenti link.

Node.js

Distribuisci funzioni Lambda in Node.js con archivi di file .zip

Typescript

Implementare il codice TypeScript trasformato in Lambda con gli archivi di file .zip

Python

Utilizzo di archivi di file .zip per le funzioni Lambda in Python

Ruby

Distribuire le funzioni Ruby Lambda con gli archivi di file .zip

Java

Distribuisci funzioni Lambda per Java con archivi di file .zip o JAR

Go

Distribuisci funzioni Lambda per Go con gli archivi di file .zip

C#

Crea e implementa le funzioni Lambda C# con gli archivi di file .zip
Per informazioni su come richiamare una funzione Lambda utilizzando un altro Servizio AWS, consulta Tutorial: uso di un trigger Amazon S3 per richiamare una funzione Lambda.
Scegli uno dei seguenti tutorial per esempi più complessi di utilizzo di Lambda con altri Servizi AWS.
- Tutorial: uso di Lambda con Amazon API Gateway: crea una REST API di Gateway Amazon API che richiama una funzione Lambda.
- Utilizzo di una funzione Lambda per accedere a un database Amazon RDS: utilizza una funzione Lambda per scrivere dati in un database Amazon Relational Database Service (Amazon RDS) tramite un proxy RDS.
- Utilizzo di un trigger Amazon S3 per creare anteprime: utilizza una funzione Lambda per creare un'anteprima ogni volta che un file immagine viene caricato in un bucket Amazon S3.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Progettazione di un'applicazione

App e modelli di esempio