Lavora con dati di valore chiave - Amazon CloudFront
Lavora con coppie chiave-valore (console)Informazioni su CloudFront KeyValueStoreLavora con coppie chiave-valore ()AWS CLILavora con coppie chiave-valore (API)

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

Lavora con dati di valore chiave

Questo argomento descrive come aggiungere coppie chiave-valore a un archivio chiave-valore esistente. Per includere coppie chiave-valore quando crei inizialmente gli archivi chiave-valore, consulta. Crea un archivio di valori chiave

Lavora con coppie chiave-valore (console)

È possibile utilizzare la CloudFront console per lavorare con le coppie chiave-valore.

Per lavorare con coppie chiave-valore

  1. Accedi AWS Management Console e apri la pagina Funzioni nella CloudFront console all'indirizzo. https://console.aws.amazon.com/cloudfront/v4/home#/functions

  2. Scegliere la scheda KeyValueStores.

  3. Seleziona l'archivio dei valori delle chiavi da modificare.

  4. Nella sezione Coppie chiave-valore, scegli Modifica.

  5. È possibile aggiungere una coppia chiave-valore, eliminare una coppia chiave-valore o modificare il valore di una coppia chiave-valore esistente.

  6. Al termine, scegli Salva 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 di sessione della versione 2. Per ulteriori informazioni, consulta Utilizzo di credenziali temporanee con l'API 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 lavori con un archivio di valori chiave 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 chiave-valore esistente, utilizza il servizio. CloudFront KeyValueStore

  • 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'DescribeKeyValueStoreoperazione. Li chiami per diversi motivi. Per comprendere le differenze, consultate la tabella seguente.

CloudFront DescribeKeyValueStore API CloudFront KeyValueStore DescribeKeyValueStore API
Dati relativi al Key Value Store

Restituisce dati, come lo stato e la data dell'ultima modifica apportata all'archivio di valori chiave stesso.

Restituisce i dati sul contenuto della risorsa di archiviazione, ovvero le coppie chiave-valore nell'archivio e la dimensione del contenuto.
Dati che identificano l'archivio di valori chiave

Restituisce unETag, l'UUID e l'ARN dell'archivio di valori chiave.

Restituisce un ETag e l'ARN dell'archivio di valori chiave.
Note

  • Ciascuno DescribeKeyValueStore l'operazione restituisce un risultato diversoETag. ETagsNon sono intercambiabili.

  • Quando richiami un'operazione API per completare un'azione, devi specificare l'ETagAPI appropriata. Ad esempio, nell' CloudFront KeyValueStore DeleteKeyoperazione, si specifica ETag quanto restituito dal CloudFront KeyValueStore DescribeKeyValueStoreoperazione.

  • Quando richiami CloudFront le tue funzioni utilizzando CloudFront KeyValueStore, i valori nell'archivio valori chiave non vengono aggiornati o modificati durante l'invocazione della funzione. Gli aggiornamenti vengono elaborati tra le chiamate di una funzione.

Lavora con coppie chiave-valore ()AWS CLI

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

Elenca le coppie chiave-valore

Per elencare le coppie chiave-valore nell'archivio chiave-valore, 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"
        }
    ]
}

Ottieni coppie chiave-valore

Per ottenere una coppia chiave-valore nel tuo archivio chiave-valore, 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
}

Descrivi un archivio di valori chiave

Per descrivere un archivio di valori chiave, 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"
}

Crea una coppia chiave-valore

Per creare una coppia chiave-valore nel tuo archivio chiave-valore, 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
}

Eliminare 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
}

Aggiorna le coppie chiave-valore

È possibile utilizzare il update-keys comando per aggiornare più di una coppia 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
}

Lavora con coppie chiave-valore (API)

Segui questa sezione per lavorare con le tue coppie chiave-valore in modo programmatico.

Ottieni un riferimento a un archivio di valori chiave

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 segue:

Per ottenere un riferimento a un archivio di valori chiave

  1. Utilizzo dell'CloudFront ListKeyValueStoresOperazione API per ottenere un elenco di archivi di valori chiave. Trova l'archivio di valori chiave che desideri modificare.

  2. Utilizzo dell'CloudFrontKeyValueStore DescribeKeyValueStore Funzionamento dell'API e specifica l'archivio dei valori chiave del passaggio precedente.

    La risposta include l'ARN e l'archivio ETag di valori chiave.

    • 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

    • E ETag questo è simile al seguente esempio:

      ETVABCEXAMPLE2

Modifica le coppie chiave-valore in un archivio chiave-valore

È possibile specificare l'archivio chiave-valore che contiene la coppia chiave-valore che si desidera aggiornare.

Vedi le seguenti operazioni CloudFront KeyValueStore API:

  • CloudFrontKeyValueStore DeleteKey— Elimina una coppia chiave-valore

  • CloudFrontKeyValueStore GetKey— Restituisce una coppia chiave-valore

  • CloudFrontKeyValueStore ListKeys— Restituisce un elenco di coppie chiave-valore

  • CloudFrontKeyValueStore PutKey— È possibile eseguire le seguenti attività:

    • Crea una coppia chiave-valore in un unico archivio di valori chiave specificando un nuovo nome e valore di chiave.

    • Imposta un valore diverso in una coppia chiave-valore esistente specificando un nome di chiave esistente e un nuovo valore chiave.

  • CloudFrontKeyValueStore UpdateKeys— È possibile eseguire una o più delle seguenti azioni in un'unica operazione: all-or-nothing

    • Eliminare una o più coppie chiave-valore

    • Crea una o più nuove coppie chiave-valore

    • Imposta un valore diverso in una o più coppie chiave-valore esistenti

Codice di esempio per CloudFront KeyValueStore

Il codice seguente mostra come chiamare l'operazione DescribeKeyValueStore API per un archivio di valori chiave.

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