Metodi helper per archivi di valori delle chiavi

Questa sezione si applica se si utilizza CloudFront Key Value Store per includere valori chiave nella funzione creata. CloudFront Functions ha un modulo che fornisce tre metodi di supporto per leggere i valori dall'archivio di valori chiave.

Per utilizzare questo modulo nel codice della funzione, assicuratevi di aver associato un archivio di valori chiave alla funzione.

Quindi, includete le seguenti istruzioni nelle prime righe del codice della funzione:

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

Il tuo Key Value Store ID potrebbe essere simile al seguente: a1b2c3d4-5678-90ab-cdef-EXAMPLE1

Metodo get()

Utilizzate questo metodo per restituire il valore della chiave per il nome di chiave specificato.

Richiesta

get("key", options);

• key: il nome della chiave di cui è necessario recuperare il valore

• options: C'è un'opzione,format. Assicura che la funzione analizzi correttamente i dati. Valori possibili:

  • string: con codifica UTF8 (impostazione predefinita)

  • json

  • bytes: buffer di dati binari non elaborati

Esempio di richiesta

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

Risposta

La risposta è una promise che si risolve in un valore nel formato richiesto utilizzando. options Per impostazione predefinita, il valore viene restituito come stringa.

Metodo exists()

Utilizzate questo metodo per identificare se la chiave esiste o meno nell'archivio dei valori della chiave.

Richiesta

exists("key");

Esempio di richiesta

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

Risposta

La risposta è una promise che restituisce un valore booleano (trueofalse). Questo valore specifica se la chiave esiste o meno nell'archivio dei valori della chiave.

Gestione degli errori

Il get() metodo restituirà un errore quando la chiave richiesta non esiste nell'archivio di valori chiave associato. Per gestire questo caso d'uso, puoi aggiungere un catch blocco try and al codice.

Metodo meta()

Utilizzate questo metodo per restituire i metadati relativi all'archivio di valori chiave.

Richiesta

meta();

Esempio di richiesta

const meta = await kvsHandle.meta();

Risposta

La risposta è un valore promise che si risolve in un oggetto con le seguenti proprietà:

• creationDateTime: la data e l'ora di creazione dell'archivio di valori delle chiavi, nel formato ISO 8601.

• lastUpdatedDateTime: la data e l'ora dell'ultima sincronizzazione dell'archivio di valori delle chiavi, nel formato ISO 8601. Il valore non include il tempo di propagazione verso l'edge.

• keyCount: il numero totale di chiavi in KVS dopo l'ultima sincronizzazione dalla sorgente.

Esempio di risposta

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