Aggiungere livelli alle funzioni degli eventi

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.

Questa sezione spiega come aggiungere un layer a una funzione evento Lambda. Per ulteriori informazioni concettuali sui livelli e su come e perché utilizzarli, consulta Gestione delle dipendenze della funzione Lambda Event Function con livelli.

Prima di poter configurare una funzione evento per l'utilizzo di un layer, è necessario:

• Crea un pacchetto per il contenuto del livello

• Crea un livello in Lambda

• Assicurati di avere l'autorizzazione per chiamare l'GetLayerVersionAPI nella versione del layer. Per Event Functions in your Account AWS, devi avere questa autorizzazione nella tua politica utente. Per utilizzare un livello in un altro account, il proprietario di quell'account deve concedere l'autorizzazione per l'account in una policy basata sulle risorse. Per alcuni esempi, consulta Concessione dell'accesso ai livelli Lambda ad altri account.

È possibile aggiungere fino a cinque livelli a una funzione evento. La dimensione totale decompressa della Event Function e di tutti i layer non può superare la quota di 250 MB del pacchetto di distribuzione decompresso. Per ulteriori informazioni, consulta Quote di Lambda.

Le tue Event Functions possono continuare a utilizzare qualsiasi versione di layer che hai già aggiunto, anche dopo che quella versione del layer è stata eliminata o dopo la revoca dell'autorizzazione ad accedere al layer. Tuttavia, non è possibile creare una nuova funzione evento che utilizzi una versione di livello eliminata.

Per aggiungere un livello a una funzione di evento

1. Apri la pagina Event Functions della console Lambda.

2. Scegli la funzione Event.

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. AWS livelli: scegli dall'elenco delle estensioni AWS gestite.

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

   3. Specificare un ARN: per utilizzare un layer di un altro livello Account AWS, ad esempio un'estensione di terze parti, inserisci Amazon Resource Name (ARN).

5. Scegliere 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.

Per aggiornare l'ordine di unione dei livelli per la tua Event Function (console)

1. Apri la pagina Event Functions della console Lambda.

2. Scegli la funzione Event 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. Puoi usare la console per aggiornare la versione del layer allegata alle tue Event Functions.

Per aggiornare le versioni dei layer per la tua Event Function (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 degli eventi 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 del livello Event Function tra più AWS account.

Ricerca di informazioni sul livello

Per trovare livelli nel tuo account compatibili con il runtime della tua Event Function, usa l'ListLayersAPI. Ad esempio, è possibile utilizzare il seguente comando list-layers ( AWS Command Line Interface CLI):

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

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.14"
                ]
            }
        }
    ]
}

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

È inoltre possibile ottenere la versione più recente di un layer utilizzando l'API. 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"
            ]
        }
    ]
}