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 di valori chiave 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. Scegli la KeyValueStoresscheda.

  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 le modifiche.

Informazioni su CloudFront KeyValueStore

Suggerimento

CloudFront KeyValueStore APISi tratta di 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 CloudFront KeyValueStore API.

Se stai usando il AWS Command Line Interface (AWS CLI) o il tuo codice per chiamare il CloudFront KeyValueStore API, consulta le seguenti sezioni.

Quando lavori con un archivio chiave-valore 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

Entrambi CloudFront KeyValueStore API hanno CloudFront API 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 un ETagUUID, il e il ARN dell'archivio di valori chiave.

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

  • Ogni DescribeKeyValueStore operazione ne restituisce una diversaETag. ETagsNon sono intercambiabili.

  • Quando si chiama un'APIoperazione per completare un'azione, è necessario specificare il campo ETag appropriato. API Ad esempio, nell' CloudFront KeyValueStore DeleteKeyoperazione, si specifica ETag ciò che si è restituito dall' CloudFront KeyValueStore DescribeKeyValueStoreoperazione.

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 coppie chiave-valore in modo programmatico.

Ottieni un riferimento a un archivio di valori chiave

Quando si utilizza CloudFront KeyValueStore API per chiamare un'operazione di scrittura, è necessario specificare l'ARNe ETag del key value store. Per ottenere questi dati, procedi come segue:

Per ottenere un riferimento a un archivio di valori chiave

  1. Utilizzate l'CloudFront ListKeyValueStoresAPIoperazione per ottenere un elenco di archivi di valori chiave. Trova l'archivio di valori chiave che desideri modificare.

  2. Usa l'CloudFrontKeyValueStore DescribeKeyValueStoreAPIoperazione e specifica l'archivio dei valori chiave del passaggio precedente.

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

    • ARNInclude il Account AWS numero, la costante key-value-store e ilUUID, 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.

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