Trabajo con datos de clave-valor

Este tema describe cómo agregar pares clave-valor a un almacén de clave-valor existente. Para incluir pares clave-valor al crear inicialmente los almacenes de clave-valor, consulte Creación de un almacén de clave-valor.

Uso de pares clave-valor (consola)

Puede utilizar la consola de CloudFront para trabajar con los pares clave-valor.

Acerca de CloudFront KeyValueStore

Si utiliza la AWS Command Line Interface (AWS CLI) o el código propio para llamar a la API KeyValueStore de CloudFront, consulte las secciones siguientes.

Cuando trabaja con un almacén de clave-valor y sus pares clave-valor, el servicio al que llame depende del caso de uso:

Tanto la API de CloudFront como la API de CloudFront KeyValueStore tienen una operación DescribeKeyValueStore. Las llama por diferentes motivos. Para entender las diferencias, consulte la siguiente tabla.

Uso de pares clave-valor (AWS CLI)

Puede ejecutar los siguientes comandos de la AWS Command Line Interface para KeyValueStore de CloudFront.

Enumeración de pares clave-valor

Para enumerar los pares clave-valor del almacén de clave-valor, ejecute el siguiente comando.

aws cloudfront-keyvaluestore list-keys \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Respuesta

{
    "Items": [
        {
            "Key": "key1",
            "Value": "value1"
        }
    ]
}

Obtención de pares clave-valor

Para obtener un par clave-valor del almacén de clave-valor, ejecute el siguiente comando.

aws cloudfront-keyvaluestore get-key \
    --key=key1 \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Respuesta

{
    "Key": "key1",
    "Value": "value1",
    "ItemCount": 1,
    "TotalSizeInBytes": 11
}

Descripción de un almacén de clave-valor

Para describir un almacén de clave-valor, ejecute el siguiente comando.

aws cloudfront-keyvaluestore describe-key-value-store \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Respuesta

{
    "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"
}

Creación de un par clave-valor

Para crear un par clave-valor en el almacén de clave-valor, ejecute el siguiente comando.

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

Respuesta

{
    "ETag": "KV13V1IB3VIYZZH",
    "ItemCount": 3,
    "TotalSizeInBytes": 31
}

Eliminación de un par clave-valor

Para eliminar un par clave-valor, ejecute el siguiente comando.

aws cloudfront-keyvaluestore delete-key \
    --if-match=KV13V1IB3VIYZZH \
    --key=key1 \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Salida

{
    "ETag": "KV1VC38T7YXB528",
    "ItemCount": 2,
    "TotalSizeInBytes": 22
}

Actualización de pares clave-valor

Puede utilizar el comando update-keys para actualizar más de un par clave-valor. Por ejemplo, para eliminar un par clave-valor existente y crear otro, ejecute el siguiente comando.

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"}]'

Respuesta

{
    "ETag": "KV3AEGXETSR30VB",
    "ItemCount": 3,
    "TotalSizeInBytes": 28
}

Uso de pares clave-valor (API)

Siga esta sección para trabajar con los pares clave-valor mediante programación.

Obtención de una referencia a un almacén de clave-valor

Cuando utilice la API KeyValueStore de CloudFront para llamar a una operación de escritura, debe especificar el ARN y la ETag del almacén de clave-valor. Para obtener estos datos, haga lo siguiente:

Cambio de los pares clave-valor en un almacén de clave-valor

Puede especificar el almacén de clave-valor que contiene el par clave-valor que desea actualizar.

Consulte las siguientes operaciones de la API de CloudFront KeyValueStore:

Código de ejemplo para 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);
  }
})();