

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Aggiunta di livelli alle funzioni
<a name="adding-layers"></a>

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](runtimes-custom.md) 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](chapter-layers.md).

Prima di poter configurare una funzione Lambda per utilizzare un livello, è necessario:
+ [Crea un pacchetto per il contenuto del livello](packaging-layers.md)
+ [Crea un livello in Lambda](creating-deleting-layers.md)
+ Assicurati di avere l'autorizzazione per chiamare l'[GetLayerVersion](https://docs.aws.amazon.com/lambda/latest/api/API_GetLayerVersion.html)API nella versione del layer. Per le funzioni incluse nella tua Account AWS, devi avere questa autorizzazione nella tua [politica utente](access-control-identity-based.md). 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](access-control-resource-based.md). Per alcuni esempi, consulta [Concessione dell'accesso ai livelli Lambda ad altri account](permissions-layer-cross-account.md).

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](gettingstarted-limits.md).

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](https://console.aws.amazon.com/lambda/home#/functions) della console Lambda.

1. Scegli la funzione.

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

1. In **Scegli un livello**, scegli un'origine del livello:

   1. **AWS livelli**: scegli dall'elenco delle [estensioni AWS gestite](extensions-api-partners.md#aws-managed-extensions).

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

   1. **Specificare un ARN**: per utilizzare un layer [di un altro](permissions-layer-cross-account.md) livello Account AWS, ad esempio un'[estensione di terze parti](extensions-api-partners.md), inserisci Amazon Resource Name (ARN).

1. 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.

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

1. Aprire la pagina [Funzioni](https://console.aws.amazon.com/lambda/home#/functions) della console Lambda.

1. Scegli la funzione da configurare.

1. In **Layers (Livelli)**, scegli **Edit (Modifica)**

1. Scegli uno dei livelli.

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

1. Scegli **Save** (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](https://console.aws.amazon.com/lambda/home#/layers) (Livelli) nella console Lambda.

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

1. Seleziona la scheda **Funzioni che utilizzano questa versione**.

1. Scegli le funzioni che desideri modificare, quindi scegli **Modifica**.

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

1. Scegliere **Update functions** (Aggiorna funzioni).

Non è possibile aggiornare le versioni del Function Layer tra più account AWS .

## Ricerca di informazioni sul livello
<a name="finding-layer-information"></a>

Per trovare livelli nel tuo account compatibili con il runtime della tua funzione, usa l'[ListLayers](https://docs.aws.amazon.com/lambda/latest/api/API_ListLayers.html)API. Ad esempio, è possibile utilizzare il seguente comando [list-layers (](https://docs.aws.amazon.com/cli/latest/reference/lambda/list-layers.html) 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](https://docs.aws.amazon.com/lambda/latest/api/API_ListLayerVersions.html) 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"
            ]
        }
    ]
}
```