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

# Tutorial: crea una CloudFront funzione che includa valori chiave
<a name="functions-tutorial-kvs"></a>

Questo tutorial mostra come includere i valori chiave nella CloudFront funzione. I valori delle chiavi fanno parte di una coppia chiave-valore. Il nome (della coppia chiave-valore) viene incluso nel codice della funzione. Quando la funzione viene eseguita, CloudFront sostituisce il nome con il valore. 

Le coppie chiave-valore sono variabili memorizzate in un archivio di valori delle chiavi. Se vi utilizzi una chiave (anziché valori a codifica fissa), la funzione è più flessibile. Puoi modificare il valore della chiave senza dover implementare modifiche al codice. Le coppie chiave-valore possono anche ridurre le dimensioni della funzione. Per ulteriori informazioni, consulta [Amazon CloudFront KeyValueStore](kvs-with-functions.md).

**Contents**
+ [Prerequisiti](#functions-kvs-tutorial-prerequisites)
+ [Creazione dell’archivio di valori delle chiavi](#functions-kvs-tutorial-kvs-step)
+ [Aggiunta di coppie chiave-valore all’archivio di valori delle chiavi](#add-key-value-pairs-to-store)
+ [Associazione dell’archivio di valori delle chiavi alla funzione](#functions-kvs-tutorial-functions-step)
+ [Test e pubblicazione del codice della funzione](#test-and-publish-function-code)

## Prerequisiti
<a name="functions-kvs-tutorial-prerequisites"></a>

Se non conosci CloudFront le funzioni di Functions e il key value store, ti consigliamo di seguire il tutorial in[Tutorial: crea una funzione semplice con CloudFront Functions](functions-tutorial.md).

Dopo aver completato il tutorial, puoi seguirlo per estendere la funzione che hai creato. Per questo tutorial, ti consigliamo di creare prima l’archivio di valori delle chiavi. 

## Creazione dell’archivio di valori delle chiavi
<a name="functions-kvs-tutorial-kvs-step"></a>

Innanzitutto, crea l’archivio di valori delle chiavi da utilizzare per la funzione.

**Come creare l’archivio di valori delle chiavi**

1. Pianifica le coppie chiave-valore da includere nella funzione. Annota i nomi delle chiavi. Le coppie chiave-valore da utilizzare in una funzione devono trovarsi in un unico archivio di valori delle chiavi. 

1. Decidi l'ordine di lavoro. Puoi procedere in due modi:
   + Crea un archivio di valori delle chiavi e aggiungi coppie chiave-valore. Quindi puoi creare (o modificare) la funzione e incorporare i nomi delle chiavi.
   + In alternativa, puoi creare (o modificare) la funzione e incorporare i nomi delle chiavi da utilizzare. Quindi, crea un archivio di valori delle chiavi e aggiungi le coppie chiave-valore.

1. Accedi a Console di gestione AWS e apri la CloudFront console all'indirizzo[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).

1. Nel riquadro di navigazione, scegli **Funzioni**, quindi scegli la **KeyValueStores**scheda.

1. Scegli **Crea KeyValueStore** e inserisci i seguenti campi:
   + Immetti un nome e una descrizione (facoltativa) per l’archivio. 
   + Lascia vuoto il campo **URI S3**. In questo tutorial le coppie chiave-valore verranno inserite manualmente. 

1. Scegli **Create** (Crea). Viene visualizzata la pagina dei dettagli relativa al nuovo archivio di valori delle chiavi. Questa pagina include una sezione **Coppie chiave-valore** che al momento è vuota.

## Aggiunta di coppie chiave-valore all’archivio di valori delle chiavi
<a name="add-key-value-pairs-to-store"></a>

Successivamente, aggiungi manualmente un elenco di coppie chiave-valore all’archivio di valori delle chiavi creato in precedenza.

**Come aggiungere coppie chiave-valore all’archivio di valori delle chiavi**

1. Nella sezione **Coppie chiave-valore**, scegli **Aggiungi coppie chiave-valore**. 

1. Scegli **Aggiungi coppia** e quindi inserisci una chiave e un valore. Seleziona il segno di spunta per confermare le modifiche e ripeti questa fase per aggiungerne altre.

1. Al termine, scegli **Salva modifiche** per salvare le coppie chiave-valore nell’archivio di valori delle chiavi. Nel finestra di dialogo di conferma, seleziona **Fatto**.

Ora hai un archivio di valori delle chiavi che contiene un gruppo di coppie chiave-valore. 



## Associazione dell’archivio di valori delle chiavi alla funzione
<a name="functions-kvs-tutorial-functions-step"></a>

Ora hai creato l'archivio di valori delle chiavi. Hai inoltre creato o modificato una funzione che include i nomi delle chiavi dall'archivio di valori delle chiavi. Ora puoi associare l'archivio di valori delle chiavi e la funzione. È possibile creare tale associazione dall'interno della funzione. 

**Come associare l’archivio di valori delle chiavi alla funzione**

1. Nel riquadro di navigazione, seleziona **Funzioni**. Per impostazione predefinita, la scheda **Funzioni** viene visualizzata in alto. 

1. Scegliete il nome della funzione e nella KeyValueStore sezione **Associato**, scegliete **Associa esistente KeyValueStore**.

1. Seleziona l'archivio di valori chiave e scegli **Associa KeyValueStore**. 

**Nota**  
Puoi associare un solo archivio di valori delle chiavi a ciascuna funzione.

## Test e pubblicazione del codice della funzione
<a name="test-and-publish-function-code"></a>

Dopo aver associato l’archivio dei valori delle chiavi alla funzione, puoi testare e pubblicare il codice della funzione. È sempre consigliabile testare il codice della funzione a ogni modifica, anche per le seguenti operazioni:
+ Associazione dell'archivio di valori delle chiavi alla funzione
+ Modifica la funzione e il rispettivo archivio di valori delle chiavi per includere una nuova coppia chiave-valore.
+ Modifica il valore di una coppia chiave-valore.

**Come eseguire il test e pubblicare il codice della funzione**

1. Per ulteriori informazioni su come testare una funzione, consulta [Test delle funzioni](test-function.md). Verifica di aver scelto di testare la funzione nella fase `DEVELOPMENT`.

1. Pubblica la funzione quando hai tutto pronto per utilizzarla (con le coppie chiave-valore nuove o modificate) in un ambiente `LIVE`. 

   Quando CloudFront pubblicate, copia la versione della funzione dallo `DEVELOPMENT` stage al live stage. La funzione ha il nuovo codice ed è associata all'archivio di valori delle chiavi. Non è necessario ripetere l'associazione nella fase live.

   Per ulteriori informazioni su come pubblicare una funzione, consulta [Pubblicazione di funzioni](publish-function.md).