Métodos auxiliares para almacenes de clave-valor

Esta sección se aplica si utiliza el Almacén de clave-valor de CloudFront para incluir claves-valores en la función que cree. CloudFront Functions tiene un módulo que proporciona tres métodos auxiliares para leer valores del almacén de clave-valor.

Para utilizar este módulo en el código de la función, asegúrese de haber asociado un almacén de clave-valor a la función.

A continuación, incluya las siguientes instrucciones en las primeras líneas del código de la función:

import cf from 'cloudfront';
const kvsId = "key value store ID";
const kvsHandle = cf.kvs(kvsId);

El ID de almacén de clave-valor tendría el siguiente aspecto: a1b2c3d4-5678-90ab-cdef-EXAMPLE1

Método de get()

Utilice este método para devolver el valor de clave del nombre de clave que especifique.

Solicitud

get("key", options);

Ejemplo de solicitud

const value = await kvsHandle.get("myFunctionKey", { format: "string"});

Respuesta

La respuesta es una promise que se resuelve en un valor en el formato solicitado mediante el uso de options. De forma predeterminada, el valor se devuelve como una cadena.

Control de errores

El método get() devolverá un error cuando la clave que ha solicitado no exista en el almacén de clave-valor asociado. Para administrar este caso de uso, puede agregar un bloque try y catch al código.

Método de exists()

Utilice este método para identificar si la clave existe o no en el almacén de clave-valor.

Solicitud

exists("key");

Ejemplo de solicitud

const exist = await kvsHandle.exists("myFunctionkey");

Respuesta

La respuesta es una promise que devuelve un valor booleano (true o false). Este valor especifica si la clave existe o no en el almacén de clave-valor.

Método de meta()

Utilice este método para devolver metadatos sobre el almacén de clave-valor.

Solicitud

meta();

Ejemplo de solicitud

const meta = await kvsHandle.meta();

Respuesta

La respuesta es una promise que se resuelve en un objeto con las siguientes propiedades:

Ejemplo de respuesta

{keyCount:3,creationDateTime:2023-11-30T23:07:55.765Z,lastUpdatedDateTime:2023-12-15T03:57:52.411Z}