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à.
# 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);
}
})();
```