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.

Utilizzo di coppie chiave-valore (console)

Puoi usare la CloudFront console per lavorare con le tue coppie chiave-valore.

Informazioni su CloudFront KeyValueStore

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:

Sia l' CloudFront API che l' CloudFront KeyValueStore API hanno un'DescribeKeyValueStoreoperazione. Vengono chiamate per diversi motivi. Per comprendere le differenze, consulta la tabella seguente.

Utilizzo di coppie chiave-valore (AWS CLI)

È possibile eseguire i seguenti AWS Command Line Interface comandi per. CloudFront KeyValueStore

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.

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:

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

Codice di esempio per CloudFront KeyValueStore

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);
  }
})();