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 utilizzare la console CloudFront per utilizzare le coppie chiave-valore.

Informazioni su KeyValueStore di CloudFront

Se utilizzi AWS Command Line Interface (AWS CLI) o il tuo codice per chiamare l’API KeyValueStore di CloudFront, 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’API di CloudFront che l’API di KeyValueStore di CloudFront dispongono di un’operazione DescribeKeyValueStore. Vengono chiamate per diversi motivi. Per comprendere le differenze, consulta la tabella seguente.

Utilizzo di coppie chiave-valore (AWS CLI)

Puoi eseguire i comandi AWS Command Line Interface seguenti per KeyValueStore di CloudFront.

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 utilizzi l’API KeyValueStore di CloudFront per chiamare un’operazione di scrittura, devi specificare l’ARN e l’ETag dell’archivio di valori delle chiavi. 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.

Consulta le seguenti operazioni API di KeyValueStore di CloudFront:

Codice di esempio per KeyValueStore di CloudFront

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