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

# Ottenere un riferimento a un archivio di valori delle chiavi
<a name="kvs-with-functions-get-reference"></a>

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