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à.
# Amazon CloudFront KeyValueStore
CloudFront KeyValueStore è un datastore di valori chiave sicuro, globale e a bassa latenza che consente l'accesso in lettura dall'interno di [CloudFront Functions](cloudfront-functions.md), abilitando una logica personalizzabile avanzata nelle sedi periferiche. CloudFront
Con CloudFront KeyValueStore, si effettuano aggiornamenti al codice della funzione e ai dati associati a una funzione indipendentemente l'uno dall'altro. Questa separazione semplifica il codice della funzione e agevola l'aggiornamento dei dati senza la necessità di implementare modifiche al codice.
**Nota**
Per essere utilizzata CloudFront KeyValueStore, la CloudFront funzione deve utilizzare [JavaScript runtime 2.0](functions-javascript-runtime-20.md).
Di seguito è riportata la procedura generale per l’utilizzo delle coppie chiave-valore:
+ Crea archivi di valori delle chiavi e compilali con un set di coppie chiave-valore. Puoi aggiungere archivi di valori delle chiavi a un bucket Amazon S3 o inserirli manualmente.
+ Associate gli archivi di valori chiave alla vostra CloudFront funzione.
+ All'interno del codice della funzione, utilizza il nome della chiave per recuperare il valore associato alla chiave stessa o stabilire se ne esiste una. Per ulteriori informazioni sull’utilizzo delle coppie chiave-valore nel codice della funzione e per informazioni sui metodi dell’assistente di gestione, consulta [Metodi helper per archivi di valori delle chiavi](functions-custom-methods.md).
## Casi d’uso
Puoi utilizzare coppie chiave-valore per i seguenti esempi:
+ **Riscritture o reindirizzamenti degli URL**: la coppia chiave-valore può contenere la riscrittura o il reindirizzamento. URLs URLs
+ **Flag di funzionalità e test A/B**: puoi creare una funzione per eseguire esperimenti assegnando una percentuale di traffico a una versione specifica del sito web.
+ **Autorizzazione di accesso**: puoi implementare il controllo degli accessi per consentire o rifiutare richieste in base ai criteri definiti e ai dati archiviati in un archivio di valori delle chiavi.
## Formati supportati per i valori
Puoi archiviare il valore in una coppia chiave-valore in uno qualsiasi dei seguenti formati:
+ Stringa
+ Stringa con codifica in byte
+ JSON
## Sicurezza
La CloudFront funzione e tutti i relativi archivi di valori chiave vengono gestiti in modo sicuro, come segue:
+ CloudFront crittografa ogni archivio di valori chiave a riposo e durante il transito (durante la lettura o la scrittura negli archivi di valori chiave) quando si richiamano le [CloudFront KeyValueStore](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_Operations_Amazon_CloudFront_KeyValueStore.html)operazioni API.
+ Quando la funzione viene eseguita, CloudFront decripta ogni coppia chiave-valore in memoria nelle posizioni periferiche. CloudFront
Per iniziare CloudFront KeyValueStore, consulta i seguenti argomenti.
**Topics**
+ [Casi d’uso](#key-value-store-use-cases)
+ [Formati supportati per i valori](#key-value-store-supported-formats)
+ [Sicurezza](#key-value-store-security)
+ [Utilizzo dell’archivio di valori delle chiavi](kvs-with-functions-kvs.md)
+ [Utilizzo dei dati dei valori delle chiavi](kvs-with-functions-kvp.md)
+ Per ulteriori informazioni su come iniziare CloudFront KeyValueStore, consulta il post del CloudFront KeyValueStore AWS blog [Introducing Amazon](https://aws.amazon.com/blogs/aws/introducing-amazon-cloudfront-keyvaluestore-a-low-latency-datastore-for-cloudfront-functions/).
# Utilizzo dell’archivio di valori delle chiavi
È necessario creare un archivio chiave-valore per contenere le coppie chiave-valore che si desidera utilizzare in CloudFront Functions.
Dopo aver creato gli archivi di valori chiave e le coppie chiave-valore aggiunto, è possibile utilizzare i valori chiave nel codice della funzione. CloudFront
Per iniziare, consulta i seguenti argomenti:
**Topics**
+ [Creazione di un archivio di valori delle chiavi](kvs-with-functions-create.md)
+ [Associazione di un archivio di valori delle chiavi a una funzione](kvs-with-functions-associate.md)
+ [Aggiornamento di un archivio di valori delle chiavi](kvs-with-functions-edit.md)
+ [Ottenere un riferimento a un archivio di valori delle chiavi](kvs-with-functions-get-reference.md)
+ [Eliminazione di un archivio di valori delle chiavi](kvs-with-functions-delete.md)
+ [Formato file per coppie chiave-valore](kvs-with-functions-create-s3-kvp.md)
**Nota**
Il JavaScript runtime 2.0 include alcuni metodi di supporto per lavorare con i valori chiave nel codice della funzione. Per ulteriori informazioni, consulta [Metodi helper per archivi di valori delle chiavi](functions-custom-methods.md).
# Creazione di un archivio di valori delle chiavi
Puoi creare contemporaneamente un archivio di valori delle chiavi e le rispettive coppie chiave-valore. Ora, puoi anche creare un archivio di valori delle chiavi vuoto e aggiungere le coppie chiave-valore in un secondo momento.
**Nota**
Se specifichi l’origine dati da un bucket Amazon S3, devi disporre delle autorizzazioni `s3:GetObject` e `s3:GetBucketLocation` per tale bucket. Se non disponi di queste autorizzazioni, non CloudFront puoi creare correttamente il tuo archivio di valori chiave.
Scegli se desideri aggiungere coppie chiave-valore contemporaneamente alla creazione dell’archivio di valori delle chiavi. Puoi importare le coppie chiave-valore utilizzando la CloudFront console, l' CloudFrontAPI o. AWS SDKs Tuttavia, puoi importare il file di coppie chiave-valore solo quando crei *inizialmente* l’archivio di valori delle chiavi.
Per creare un file di coppie chiave-valore, consulta [Formato file per coppie chiave-valore](kvs-with-functions-create-s3-kvp.md).
------
#### [ Console ]
**Come creare un archivio di valori delle chiavi**
1. Accedi Console di gestione AWS e apri la pagina **Funzioni** nella CloudFront console all'indirizzo. [https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions)
1. Scegli la **KeyValueStores**scheda, quindi scegli **Crea KeyValueStore**.
1. Immetti un nome e una descrizione facoltativa per l'archivio di valori delle chiavi.
1. Completa **URI S3**:
+ Se disponi di un file di coppie chiave-valore, inserisci il percorso del bucket Amazon S3 in cui hai archiviato il file.
+ Lascia vuoto questo campo se intendi inserire manualmente le coppie chiave-valore.
1. Scegli **Create** (Crea). L’archivio di valori delle chiavi ora esiste.
Viene visualizzata la pagina dei dettagli relativa al nuovo archivio di valori delle chiavi. Le informazioni sulla pagina includono l'ID e l'ARN dell'archivio di valori delle chiavi.
+ L'ID è una stringa casuale di caratteri che è unica nel tuo Account AWS.
+ La sintassi dell'ARN è la seguente:
*Account AWS*`:key-value-store/`*the key value stores ID*
1. Osserva la sezione **Coppie chiave-valore**. Se hai importato un file, in questa sezione vengono visualizzate alcune coppie chiave-valore. Puoi fare quanto segue:
+ Se hai importato un file, puoi anche aggiungere altri valori manualmente.
+ Se non hai importato un file da un bucket Amazon S3 e vuoi aggiungere subito coppie chiave-valore, puoi completare la fase successiva.
+ Puoi ignorare questa fase e aggiungere le coppie chiave-valore in un secondo momento.
1. Per aggiungere subito le coppie:
1. Scegli **Aggiungi coppie chiave-valore**.
1. Scegli **Aggiungi coppia** e inserisci un nome e un valore. Ripeti questa fase per aggiungere altre coppie.
1. Al termine, scegli **Salva modifiche** per salvare tutte le coppie chiave-valore nell’archivio di valori delle chiavi. Nella finestra di dialogo visualizzata, scegli **Fatto**.
1. Per associare subito l’archivio di valori delle chiavi a una funzione, completa la sezione **Funzioni associate**. Per ulteriori informazioni, consulta [Creazione di funzioni](create-function.md) o [Aggiornamento delle funzioni](update-function.md).
Puoi associare la funzione in un secondo momento, dalla pagina dei dettagli di questo archivio di valori delle chiavi o dalla pagina dei dettagli della funzione.
------
#### [ AWS CLI ]
**Come creare un archivio di valori delle chiavi**
+ Esegui il comando seguente per creare un archivio di valori delle chiavi e importare le coppie chiave-valore da un bucket Amazon S3.
```
aws cloudfront create-key-value-store \
--name=keyvaluestore1 \
--comment="This is my key value store file" \
--import-source=SourceType=S3,SourceARN=arn:aws:s3:::amzn-s3-demo-bucket1/kvs-input.json
```
**Risposta**
```
{
"ETag": "ETVABCEXAMPLE",
"Location": "https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"KeyValueStore": {
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"Comment": "This is my key value store file",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "PROVISIONING",
"LastModifiedTime": "2024-08-06T22:19:10.813000+00:00"
}
}
```
------
#### [ API ]
**Come creare un archivio di valori delle chiavi**
1. Usa l'[CloudFrontCreateKeyValueStore](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateKeyValueStore.html)operazione. L'operazione richiede diversi parametri:
+ un `name` dell’archivio di valori delle chiavi;
+ un parametro `comment` che includa un commento;
+ un parametro `import-source` che consenta di importare coppie chiave-valore da un file archiviato in un bucket Amazon S3. Puoi importare da un file solo la prima volta che crei l’archivio di valori delle chiavi. Per informazioni sulla struttura dei file, consulta [Formato file per coppie chiave-valore](kvs-with-functions-create-s3-kvp.md).
La risposta dell'operazione include le informazioni seguenti:
+ i valori trasmessi nella richiesta, incluso il nome assegnato;
+ dati come l'ora di creazione;
+ un `ETag` (ad esempio, `ETVABCEXAMPLE`), l’ARN che include il nome dell’archivio di valori delle chiavi (ad esempio, `arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1`).
Per utilizzare l’archivio di valori delle chiavi a livello di codice, utilizzerai una combinazione di `ETag`, ARN e nome.
------
## Stati dell’archivio di valori delle chiavi
Quando crei un archivio di valori delle chiavi, i valori di stato del datastore possono essere i seguenti.
****
| Valore | Description |
| --- | --- |
| **Approvvigionamento** | L'archivio di valori chiave è stato creato e CloudFront sta elaborando l'origine dati specificata. |
| **Pronto** | L'archivio di valori chiave è stato creato ed ha elaborato CloudFront correttamente l'origine dati specificata. |
| **Importazione non riuscita** | CloudFront non è stato in grado di elaborare l'origine dati specificata. Questo stato può essere visualizzato se il formato file non è valido o se supera il limite di dimensioni. Per ulteriori informazioni, consulta [Formato file per coppie chiave-valore](kvs-with-functions-create-s3-kvp.md). |
# Associazione di un archivio di valori delle chiavi a una funzione
Dopo aver creato l’archivio di valori delle chiavi, puoi aggiornare la funzione per associarla all’archivio di valori delle chiavi. Questa associazione è necessaria per utilizzare le coppie chiave-valore di tale archivio nella funzione. Si applicano le regole seguenti:
+ Una funzione può avere un solo archivio di valori delle chiavi
+ Puoi associare lo stesso archivio di valori delle chiavi a più funzioni
------
#### [ Console ]
**Come associare un archivio di valori delle chiavi a una funzione**
1. Accedi alla CloudFront console all'indirizzo [https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions) e scegli la pagina **Funzioni**.
1. Scegli il nome della funzione.
1. Vai alla KeyValueStore sezione **Associa** e scegli **Associa esistente KeyValueStore**.
1. **Seleziona l'archivio chiave-valore che contiene le coppie chiave-valore nella funzione, quindi scegli Associa. KeyValueStore**
CloudFront associa immediatamente l'archivio alla funzione. Non è necessario salvare la funzione.
1. Per specificare un diverso archivio di valori chiave, scegliete **Aggiorna associato KeyValueStore**, selezionate il nome di un altro archivio di valori chiave, quindi scegliete **Associa KeyValueStore**.
Per ulteriori informazioni, consulta [Aggiornamento delle funzioni](update-function.md).
------
#### [ AWS CLI ]
**Come associare un archivio di valori delle chiavi a una funzione**
+ Esegui il comando seguente per aggiornare la funzione `MaxAge` e associare una risorsa dell’archivio di valori delle chiavi.
```
aws cloudfront update-function \
--name MaxAge \
--function-config '{"Comment":"Max Age 2 years","Runtime":"cloudfront-js-2.0","KeyValueStoreAssociations":{"Quantity":1,"Items":[{"KeyValueStoreARN":"arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example"}]}}' \
--function-code fileb://function-max-age-v1.js \
--if-match ETVABCEXAMPLE
```
+ Per associare un archivio di valori delle chiavi a una funzione, specifica il parametro `KeyValueStoreAssociations` e l’ARN dell’archivio di valori delle chiavi.
+ Per modificare l’associazione, specifica un altro ARN dell’archivio di valori delle chiavi.
+ Per rimuovere l’associazione, rimuovi il parametro `KeyValueStoreAssociations`.
Per ulteriori informazioni, consulta [Aggiornamento delle funzioni](update-function.md).
------
#### [ API ]
**Come associare un archivio di valori delle chiavi a una funzione**
+ Usa l'operazione API [UpdateFunction](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateFunction.html). Per ulteriori informazioni, consulta [Aggiornamento delle funzioni](update-function.md).
------
**Note**
Se modifichi un archivio di valori delle chiavi senza cambiare le coppie chiave-valore, o se modifichi solo le coppie chiave-valore nell’archivio di valori delle chiavi, non devi associare nuovamente l’archivio di valori delle chiavi. Inoltre, non è necessario ripubblicare la funzione.
Tuttavia, ti consigliamo di testare la funzione per verificare che funzioni nel modo previsto. Per ulteriori informazioni, consulta [Test delle funzioni](test-function.md).
Puoi visualizzare tutte le funzioni che utilizzano un archivio di valori delle chiavi specifico. Sulla CloudFront console, scegli la pagina dei dettagli del key value store.
# Aggiornamento di un archivio di valori delle chiavi
Quando aggiorni un archivio di valori delle chiavi, puoi modificare le coppie chiave-valore o modificare l’associazione tra l’archivio di valori delle chiavi e la funzione.
------
#### [ Console ]
**Come aggiornare un archivio di valori delle chiavi**
1. Accedi Console di gestione AWS e apri la pagina **Funzioni** nella CloudFront console all'indirizzo[https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Scegli la scheda **KeyValueStores**.
1. Seleziona l’archivio dei valori delle chiavi che desideri aggiornare.
+ Per aggiornare le coppie chiave-valore, scegli **Modifica** nella sezione **Coppie chiave-valore**. Puoi aggiungere o eliminare qualsiasi coppia chiave-valore. Puoi anche modificare il valore di una coppia chiave-valore esistente. Al termine, scegli **Salva le modifiche**.
+ Per aggiornare l’associazione per questo archivio di valori delle chiavi, scegli **Vai alle funzioni**. Per ulteriori informazioni, consulta [Associazione di un archivio di valori delle chiavi a una funzione](kvs-with-functions-associate.md).
------
#### [ AWS CLI ]
**Come aggiornare un archivio di valori delle chiavi**
1. **Modificare le coppie chiave-valore**: puoi aggiungere altre coppie chiave-valore, eliminare una o più coppie chiave-valore, nonché modificare il valore di una coppia chiave-valore esistente. Per ulteriori informazioni, consulta [Utilizzo dei dati dei valori delle chiavi](kvs-with-functions-kvp.md).
1. **Modificare l’associazione della funzione per l’archivio di valori delle chiavi**: per aggiornare l’associazione della funzione per l’archivio di valori delle chiavi, consulta [Associazione di un archivio di valori delle chiavi a una funzione](kvs-with-functions-associate.md).
**Suggerimento**
Avrai bisogno dell'ARN dell'archivio di valori delle chiavi. Per ulteriori informazioni, consulta [Ottenere un riferimento a un archivio di valori delle chiavi](kvs-with-functions-get-reference.md).
------
#### [ API ]
**Come aggiornare un archivio di valori delle chiavi**
1. **Modificare le coppie chiave-valore**: puoi aggiungere altre coppie chiave-valore, eliminare una o più coppie chiave-valore, nonché modificare il valore di una coppia chiave-valore esistente. Per ulteriori informazioni, consulta [Utilizzo dei dati dei valori delle chiavi](kvs-with-functions-kvp.md).
1. **Modifica l'associazione delle funzioni per l'archivio di valori chiave**: per aggiornare l'associazione delle funzioni per l'archivio di valori chiave, utilizza l'operazione [UpdateFunction](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateFunction.html)API. Per ulteriori informazioni, consulta [Aggiornamento delle funzioni](update-function.md).
**Suggerimento**
Avrai bisogno dell'ARN dell'archivio di valori delle chiavi. Per ulteriori informazioni, consulta [Ottenere un riferimento a un archivio di valori delle chiavi](kvs-with-functions-get-reference.md).
------
# Ottenere un riferimento a un archivio di valori delle chiavi
Per utilizzare gli archivi di valori delle chiavi a livello di codice, sono necessari l’`ETag` e il nome dell’archivio di valori delle chiavi.
Per ottenere entrambi i valori, puoi utilizzare AWS Command Line Interface (AWS CLI) o l' CloudFront API.
------
#### [ AWS CLI ]
**Come ottenere il riferimento all’archivio di valori delle chiavi**
1. Per restituire un elenco di archivi di valori delle chiavi, il seguente comando trova il nome dell’archivio di valori delle chiavi da modificare.
```
aws cloudfront list-key-value-stores
```
1. Dalla risposta, trova il nome dell’archivio di valori delle chiavi desiderato.
**Risposta**
```
{
"KeyValueStoreList": {
"Items": [
{
"Name": "keyvaluestore3",
"Id": "37435e19-c205-4271-9e5c-example3",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example3",
"Status": "READY",
"LastModifiedTime": "2024-05-08T14:50:18.876000+00:00"
},
{
"Name": "keyvaluestore2",
"Id": "47970d59-6408-474d-b850-example2",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/47970d59-6408-474d-b850-example2",
"Status": "READY",
"LastModifiedTime": "2024-05-30T21:06:22.113000+00:00"
},
{
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "READY",
"LastModifiedTime": "2024-08-06T22:19:30.510000+00:00"
}
]
}
}
```
1. Esegui il comando seguente per restituire l’`ETag` per l’archivio di valori delle chiavi specificato.
```
aws cloudfront describe-key-value-store \
--name=keyvaluestore1
```
**Risposta**
```
{
"ETag": "E3UN6WX5RRO2AG",
"KeyValueStore": {
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"Comment": "This is an example KVS",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "READY",
"LastModifiedTime": "2024-08-06T22:19:30.510000+00:00"
}
}
```
------
#### [ API ]
**Come ottenere il riferimento all’archivio di valori delle chiavi**
1. Utilizza l’operazione API [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html) per restituire un elenco di archivi di valori delle chiavi. Trova il nome dell’archivio di valori delle chiavi da modificare.
1. Utilizza l’operazione API [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DescribeKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DescribeKeyValueStore.html) e specifica il nome dell’archivio di valori delle chiavi restituito dalla fase precedente.
------
La risposta include un UUID, nonché l’ARN e l’`ETag` dell’archivio di valori delle chiavi.
+ Un `ETag`, ad esempio `E3UN6WX5RRO2AG`
+ L’UUID è a 128 bit, ad esempio `8aa76c93-3198-462c-aaf6-example`
+ L'ARN include il Account AWS numero, la costante e l'UUID`key-value-store`, come nell'esempio seguente:
`arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example`
Per ulteriori informazioni sull’operazione `DescribeKeyValueStore`, consulta [Informazioni su CloudFront KeyValueStore](kvs-with-functions-kvp.md#kvs-with-functions-api-describe).
# Eliminazione di un archivio di valori delle chiavi
Puoi eliminare il tuo archivio di valori chiave utilizzando la CloudFront console o l'API Amazon.
------
#### [ Console ]
**Come eliminare un archivio di valori delle chiavi**
1. Accedi Console di gestione AWS e apri la pagina **Funzioni** nella CloudFront console all'indirizzo[https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Scegli il nome della funzione.
1. KeyValueStoreNella sezione **Associato**, verifica se un archivio di valori chiave è associato alla funzione. In tal caso, rimuovi l'associazione scegliendo **Dissocia**, KeyValueStore quindi scegli **Rimuovi associazione**.
1. Nel riquadro di navigazione, scegli la pagina **Funzioni**, quindi scegli la **KeyValueStores**scheda.
1. Seleziona l’archivio di valori delle chiavi da eliminare, quindi scegli **Elimina**.
------
#### [ AWS CLI ]
**Come eliminare un archivio di valori delle chiavi**
1. Ottieni l’`ETag` e il nome dell’archivio di valori delle chiavi. Per ulteriori informazioni, consulta [Ottenere un riferimento a un archivio di valori delle chiavi](kvs-with-functions-get-reference.md).
1. Verifica se l’archivio di valori delle chiavi è associato a una funzione. Se lo è, rimuovi l'associazione. Per ulteriori informazioni su questi due passaggi, consulta [Aggiornamento delle funzioni](update-function.md).
1. Dopo aver ottenuto il nome e l’`ETag` dell’archivio di valori delle chiavi e dopo che questo non è più associato a una funzione, puoi eliminarlo.
Esegui il comando seguente per eliminare l’l’archivio di valori delle chiavi specificato.
```
aws cloudfront delete-key-value-store \
--name=keyvaluestore1 \
--if-match=E3UN6WX5RRO2AG
```
------
#### [ API ]
**Come eliminare un archivio di valori delle chiavi**
1. Ottieni l’`ETag` e il nome dell’archivio di valori delle chiavi. Per ulteriori informazioni, consulta [Ottenere un riferimento a un archivio di valori delle chiavi](kvs-with-functions-get-reference.md).
1. Verifica se l’archivio di valori delle chiavi è associato a una funzione. Se lo è, rimuovi l'associazione. Per ulteriori informazioni su questi due passaggi, consulta [Aggiornamento delle funzioni](update-function.md).
1. Per eliminare l'archivio dei valori chiave, utilizza l'operazione CloudFront [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteKeyValueStore.html)API.
------
# Formato file per coppie chiave-valore
Quando crei un file con codifica UTF-8, utilizza il seguente formato JSON:
```
{
"data":[
{
"key":"key1",
"value":"value"
},
{
"key":"key2",
"value":"value"
}
]
}
```
Il file non può includere chiavi duplicate. Se hai specificato un file non valido nel bucket Amazon S3, puoi aggiornare il file per rimuovere eventuali duplicati e quindi provare a creare nuovamente l’archivio di valori delle chiavi.
Per ulteriori informazioni, consulta [Creazione di un archivio di valori delle chiavi](kvs-with-functions-create.md).
**Nota**
Il file per l'origine dati e le relative coppie chiave-valore hanno i seguenti limiti:
Dimensione del file: 5 MB
Dimensione della chiave: 512 caratteri
Dimensione del valore: 1024 caratteri
# Utilizzo dei dati dei valori delle chiavi
In questa sezione viene descritto come aggiungere coppie chiave-valore a un archivio di valori delle chiavi esistente. Per includere coppie chiave-valore durante la creazione iniziale degli archivi di valori delle chiavi, consulta [Creazione di un archivio di valori delle chiavi](kvs-with-functions-create.md).
**Topics**
+ [Utilizzo di coppie chiave-valore (console)](#kvs-with-functions-kvp-using-console)
+ [Informazioni su CloudFront KeyValueStore](#kvs-with-functions-api-describe)
+ [Utilizzo di coppie chiave-valore (AWS CLI)](#work-with-kvs-cli-keys)
+ [Utilizzo di coppie chiave-valore (API)](#kvs-with-functions-kvp-using-api)
## Utilizzo di coppie chiave-valore (console)
Puoi usare la CloudFront console per lavorare con le tue coppie chiave-valore.
**Come utilizzare coppie chiave-valore**
1. Accedi Console di gestione AWS e apri la pagina **Funzioni** nella CloudFront console all'indirizzo. [https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions)
1. Scegli la scheda **KeyValueStores**.
1. Seleziona l'archivio dei valori delle chiavi da modificare.
1. Nella sezione **Coppie chiave-valore**, scegli **Modifica**.
1. Puoi aggiungere una coppia chiave-valore, eliminarla o modificare il valore di una coppia esistente.
1. Al termine, scegli **Salva le modifiche**.
## Informazioni su CloudFront KeyValueStore
**Suggerimento**
L' CloudFront KeyValueStore API è un servizio globale che utilizza Signature Version 4A (SigV4a) per l'autenticazione. L’utilizzo di credenziali temporanee con SigV4A richiede i token sessione versione 2. Per ulteriori informazioni, consulta [Utilizzo di credenziali temporanee con l'API CloudFront KeyValueStore](cloudfront-function-restrictions.md#regional-endpoint-for-key-value-store).
Se stai usando il AWS Command Line Interface (AWS CLI) o il tuo codice per chiamare l' CloudFront KeyValueStore API, consulta le seguenti sezioni.
Quando utilizzi un archivio di valori delle chiavi e le relative coppie chiave-valore, il servizio che chiami dipende dal tuo caso d’uso:
+ Per utilizzare le coppie chiave-valore in un archivio di valori chiave *esistente*, utilizza il CloudFront KeyValueStore servizio.
+ Per includere coppie chiave-valore nell'archivio valori chiave quando crei *inizialmente* l'archivio valori chiave, utilizza il servizio. CloudFront
Sia l' CloudFront API che l' CloudFront KeyValueStore API hanno un'`DescribeKeyValueStore`operazione. Vengono chiamate per diversi motivi. Per comprendere le differenze, consulta la tabella seguente.
| | API CloudFront DescribeKeyValueStore | API CloudFront KeyValueStore DescribeKeyValueStore |
| --- | --- | --- |
| Dati relativi all’archivio di valori delle chiavi | Restituisce dati quali lo stato e la data dell’ultima modifica dell’archivio di valori delle chiavi. | Restituisce dati relativi ai *contenuti* della risorsa di archiviazione: le coppie chiave-valore nell’archivio e le dimensioni del contenuto. |
| Dati che identificano l’archivio di valori delle chiavi | Restituisce un `ETag`, l’UUID e l’ARN dell’archivio di valori delle chiavi. | Restituisce un `ETag` e l’ARN dell’archivio di valori delle chiavi. |
**Note**
Ogni operazione DescribeKeyValueStore restituisce un *diverso* `ETag`. Gli `ETags` non sono intercambiabili.
Quando chiami un’operazione API per completare un’azione, devi specificare l’`ETag` dall’API appropriata. Ad esempio, nell' CloudFront KeyValueStore[ DeleteKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DeleteKey.html)operazione, si specifica `ETag` ciò che si è restituito dall' CloudFront KeyValueStore [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html)operazione.
Quando richiamate le CloudFront funzioni utilizzando CloudFront KeyValueStore, i valori nell'archivio di valori chiave non vengono aggiornati o modificati durante la chiamata della funzione. Gli aggiornamenti vengono elaborati tra le invocazioni di una funzione.
## Utilizzo di coppie chiave-valore (AWS CLI)
È possibile eseguire i seguenti AWS Command Line Interface comandi per. CloudFront KeyValueStore
**Contents**
+ [Elencare coppie chiave/valore](#kvs-cli-list-keys)
+ [Ottenere coppie chiave/valore](#kvs-cli-get-keys)
+ [Descrizione di un archivio di valori delle chiavi](#kvs-cli-describe-keys)
+ [Creazione di una coppia chiave-valore](#kvs-cli-create-keys)
+ [Eliminazione di una coppia chiave-valore](#kvs-cli-delete-keys)
+ [Aggiornamento di coppie chiave-valore](#kvs-cli-update-key)
### Elencare coppie chiave/valore
Per elencare coppie chiave-valore nell’archivio di valori delle chiavi, esegui il comando seguente.
```
aws cloudfront-keyvaluestore list-keys \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Risposta**
```
{
"Items": [
{
"Key": "key1",
"Value": "value1"
}
]
}
```
### Ottenere coppie chiave/valore
Per ottenere una coppia chiave-valore nell’archivio di valori delle chiavi, esegui il comando seguente.
```
aws cloudfront-keyvaluestore get-key \
--key=key1 \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Risposta**
```
{
"Key": "key1",
"Value": "value1",
"ItemCount": 1,
"TotalSizeInBytes": 11
}
```
### Descrizione di un archivio di valori delle chiavi
Per descrivere un archivio di valori delle chiavi, esegui il comando seguente.
```
aws cloudfront-keyvaluestore describe-key-value-store \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Risposta**
```
{
"ETag": "KV1F83G8C2ARO7P",
"ItemCount": 1,
"TotalSizeInBytes": 11,
"KvsARN": "arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example",
"Created": "2024-05-08T07:48:45.381000-07:00",
"LastModified": "2024-08-05T13:50:58.843000-07:00",
"Status": "READY"
}
```
### Creazione di una coppia chiave-valore
Per creare una coppia chiave-valore nell’archivio di valori delle chiavi, esegui il comando seguente.
```
aws cloudfront-keyvaluestore put-key \
--if-match=KV1PA6795UKMFR9 \
--key=key2 \
--value=value2 \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Risposta**
```
{
"ETag": "KV13V1IB3VIYZZH",
"ItemCount": 3,
"TotalSizeInBytes": 31
}
```
### Eliminazione di una coppia chiave-valore
Per eliminare una coppia chiave-valore, esegui il comando seguente.
```
aws cloudfront-keyvaluestore delete-key \
--if-match=KV13V1IB3VIYZZH \
--key=key1 \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Output**
```
{
"ETag": "KV1VC38T7YXB528",
"ItemCount": 2,
"TotalSizeInBytes": 22
}
```
### Aggiornamento di coppie chiave-valore
Puoi utilizzare il comando `update-keys` per aggiornare più coppie chiave-valore. Ad esempio, per eliminare una coppia chiave-valore esistente e crearne un’altra, esegui il comando seguente.
```
aws cloudfront-keyvaluestore update-keys \
--if-match=KV2EUQ1WTGCTBG2 \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example \
--deletes '[{"Key":"key2"}]' \
--puts '[{"Key":"key3","Value":"value3"}]'
```
**Risposta**
```
{
"ETag": "KV3AEGXETSR30VB",
"ItemCount": 3,
"TotalSizeInBytes": 28
}
```
## Utilizzo di coppie chiave-valore (API)
Segui questa sezione per utilizzare le coppie chiave-valore a livello di codice.
**Contents**
+ [Ottenere un riferimento a un archivio di valori delle chiavi](#kvs-with-functions-api-ref)
+ [Modifica delle coppie chiave-valore in un archivio di valori delle chiavi](#kvs-with-functions-api-actions)
+ [Codice di esempio per CloudFront KeyValueStore](#example-code-key-value-store)
### Ottenere un riferimento a un archivio di valori delle chiavi
Quando si utilizza l' CloudFront KeyValueStore API per chiamare un'operazione di scrittura, è necessario specificare l'ARN e l'archivio `ETag` dei valori della chiave. Per ottenere questi dati, procedi come descritto di seguito:
**Come ottenere un riferimento a un archivio di valori delle chiavi**
1. Utilizza l’operazione API [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html) per ottenere un elenco di archivi di valori delle chiavi. Trova l’archivio di valori delle chiavi da modificare.
1. Utilizza l’[operazione API CloudFrontKeyValueStore DescribeKeyValueStore](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html) e specifica l’archivio di valori delle chiavi della fase precedente.
La risposta include l’ARN e l’`ETag` dell’archivio di valori delle chiavi.
+ L'ARN include il Account AWS numero, la costante `key-value-store` e l'UUID, come nell'esempio seguente:
`arn:aws:cloudfront::123456789012:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`
+ Un `ETag` il cui aspetto è simile a quello dell’esempio seguente:
`ETVABCEXAMPLE2`
### Modifica delle coppie chiave-valore in un archivio di valori delle chiavi
Puoi specificare l’archivio di valori delle chiavi che contiene la coppia chiave-valore che desideri aggiornare.
Vedi le seguenti operazioni API: CloudFront KeyValueStore
+ [CloudFrontKeyValueStore DeleteKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DeleteKey.html)— Elimina una coppia chiave-valore
+ [CloudFrontKeyValueStore GetKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_GetKey.html)— Restituisce una coppia chiave-valore
+ [CloudFrontKeyValueStore ListKeys](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_ListKeys.html)— Restituisce un elenco di coppie chiave-valore
+ [CloudFrontKeyValueStore PutKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_PutKey.html)— È possibile eseguire le seguenti attività:
+ Creare una coppia chiave-valore in un unico archivio di valori delle chiavi specificando un nuovo nome e valore della chiave.
+ Impostare un valore diverso in una coppia chiave-valore esistente specificando un nome chiave esistente e un nuovo valore della chiave.
+ [CloudFrontKeyValueStore UpdateKeys](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_UpdateKeys.html)— È possibile eseguire una o più delle seguenti azioni in all-or-nothing un'unica operazione:
+ Eliminare una o più coppie chiave-valore
+ Creare una o più nuove coppie chiave-valore
+ Impostare un valore diverso in una o più coppie chiave-valore esistenti
### Codice di esempio per CloudFront KeyValueStore
**Example**
Il codice seguente mostra come chiamare l’operazione API `DescribeKeyValueStore` per un archivio di valori delle chiavi.
```
const {
CloudFrontKeyValueStoreClient,
DescribeKeyValueStoreCommand,
} = require("@aws-sdk/client-cloudfront-keyvaluestore");
require("@aws-sdk/signature-v4-crt");
(async () => {
try {
const client = new CloudFrontKeyValueStoreClient({
region: "us-east-1"
});
const input = {
KvsARN: "arn:aws:cloudfront::123456789012:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
};
const command = new DescribeKeyValueStoreCommand(input);
const response = await client.send(command);
} catch (e) {
console.log(e);
}
})();
```