Métodos auxiliares para armazenamentos de chave-valor

Esta seção se aplicará se você usar o Armazenamento de chave-valor do CloudFront para incluir chave-valor na função criada. O CloudFront Functions tem um módulo que oferece três métodos auxiliares para ler valores do armazenamento de chave-valor.

Para usar esse módulo no código da função, verifique se você associou um armazenamento de chave-valor à função.

Em seguida, inclua as seguintes declarações nas primeiras linhas do código da função:

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

Seu ID de armazenamento de chave-valor pode apresentar a seguinte aparência: a1b2c3d4-5678-90ab-cdef-EXAMPLE1

Método do get()

Use esse método para retornar o valor do nome da chave especificado.

Solicitação

get("key", options);

Exemplo de solicitação

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

Resposta

A resposta é uma promise que se resolve para um valor no formato solicitado usando options. Por padrão, o valor é retornado como uma string.

Gerenciamento de erros

O método get() retornará um erro quando a chave solicitada não existir no armazenamento de chave-valor associado. Para gerenciar esse caso de uso, é possível adicionar um bloco try e catch ao seu código.

Método do exists()

Use esse método para identificar se a chave existe ou não no armazenamento de chave-valor.

Solicitação

exists("key");

Exemplo de solicitação

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

Resposta

A resposta é uma promise que retorna um booleano (true ou false). Esse valor especifica se a chave existe ou não no armazenamento de chave-valor.

Método do meta()

Use esse método para retornar metadados sobre o armazenamento de chave-valor.

Solicitação

meta();

Exemplo de solicitação

const meta = await kvsHandle.meta();

Resposta

A resposta é uma promise que é resolvida em um objeto com as seguintes propriedades:

Exemplo de resposta

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