Aggiunta di livelli alle funzioni - AWS Lambda
Ricerca di informazioni sul livello

Aggiunta di livelli alle funzioni

Un livello Lambda è un archivio di file .zip che può contenere codice o dati aggiuntivi. I livelli di solito contengono dipendenze dalla libreria, un runtime personalizzato o file di configurazione.

In questa sezione viene spiegato come aggiungere un livello a una funzione Lambda. Per ulteriori informazioni concettuali sui livelli e su come e perché utilizzarli, consulta Gestione delle dipendenze Lambda con i livelli.

Prima di poter configurare una funzione Lambda per utilizzare un livello, è necessario:

Puoi aggiungere fino a cinque livelli a una funzione Lambda. La dimensione totale non decompressa della funzione e di tutti i livelli non può superare la quota della dimensione del pacchetto di distribuzione non compresso di 250 MB. Per ulteriori informazioni, consulta Quote di Lambda.

Le tue funzioni possono continuare a utilizzare qualsiasi versione del livello che hai già aggiunto, anche dopo che la versione del livello è stata eliminata o dopo la revoca del tuo permesso di accesso al livello. Non è tuttavia possibile creare una nuova funzione che utilizza la versione di un livello eliminato.

Aggiunta di un livello a una funzione

  1. Aprire la pagina Funzioni della console Lambda.

  2. Scegli la funzione.

  3. Scorri verso il basso fino alla sezione Livelli, quindi scegli Aggiungi un livello.

  4. In Scegli un livello, scegli un'origine del livello:

    1. Livelli AWS: scegli dall'elenco delle estensioni gestite da AWS.

    2. Livelli personalizzati: scegli un livello creato nel tuo Account AWS.

    3. Specificare un ARN: per utilizzare un livello di un altro Account AWS, ad esempio un'estensione di terze parti, inserisci il nome della risorsa Amazon (ARN).

  5. Scegli Aggiungi.

L'ordine in cui si aggiungono i livelli è l'ordine in cui Lambda unisce il contenuto del livello nell'ambiente di esecuzione. Puoi modificare l'ordine di unione dei livelli utilizzando la console.

Aggiornamento dell'ordine di unione dei livelli per la tua funzione (console)

  1. Aprire la pagina Funzioni della console Lambda.

  2. Scegli la funzione da configurare.

  3. In Layers (Livelli), scegli Edit (Modifica)

  4. Scegli uno dei livelli.

  5. Scegli Merge earlier (Unisci prima) o Merge later (Unisci in un secondo momento) per regolare l'ordine dei livelli.

  6. Selezionare Salva.

I livelli sono suddivisi in versioni. Il contenuto di ogni versione di livello non è modificabile. Il proprietario del livello può rilasciare nuove versioni del livello in modo da fornire contenuto appropriato. È possibile utilizzare la console per aggiornare la versione del livello collegata alle funzioni.

Aggiornamento delle versioni del livello per la funzione (console)

  1. Apri la pagina Layers (Livelli) nella console Lambda.

  2. Scegli il livello per il quale desideri aggiornare la versione.

  3. Seleziona la scheda Funzioni che utilizzano questa versione.

  4. Scegli le funzioni che desideri modificare, quindi scegli Modifica.

  5. Da Versione livello, seleziona la versione del livello a cui passare.

  6. Scegliere Update functions (Aggiorna funzioni).

Non è possibile aggiornare le versioni dei livelli delle funzioni negli account AWS.

Ricerca di informazioni sul livello

Per trovare i livelli nell'account compatibili con il runtime della funzione, usa l'API ListLayers. Ad esempio, puoi utilizzare il seguente comando AWS Command Line Interface (CLI) list-layers:

aws lambda list-layers --compatible-runtime python3.13

Verrà visualizzato un output simile al seguente:

{
    "Layers": [
        {
            "LayerName": "my-layer",
            "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
            "LatestMatchingVersion": {
                "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
                "Version": 2,
                "Description": "My layer",
                "CreatedDate": "2025-04-15T00:37:46.592+0000",
                "CompatibleRuntimes": [
                    "python3.13"
                ]
            }
        }
    ]
}

Per elencare tutti i livelli nell'account, ometti l'opzione --compatible-runtime. I dettagli della risposta mostrano la versione più recente di ogni livello.

L'ultima versione di un livello può essere ottenuta anche utilizzando il comando ListLayerVersions. Ad esempio, puoi utilizzare il seguente comando list-layer-versions della CLI: 

aws lambda list-layer-versions --layer-name my-layer

Verrà visualizzato un output simile al seguente:

{
    "LayerVersions": [
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
            "Version": 2,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:37:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        },
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
            "Version": 1,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:27:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        }
    ]
}