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à.
Metodi helper per archivi di valori delle chiavi
Nota
Le chiamate al metodo di supporto Key Value Store da CloudFront Functions non attivano un evento di AWS CloudTrail dati. Questi eventi non vengono registrati nella cronologia degli CloudTrail eventi. Per ulteriori informazioni, consulta Registrazione delle chiamate CloudFront API Amazon tramite AWS CloudTrail.
Questa sezione si applica se utilizzi CloudFront Key Value Store per includere valori chiave nella funzione che crei. 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 kvsHandle = cf.kvs();
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
: (Impostazione predefinita) UTF8 codificata -
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.
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 exists()
Utilizzate questo metodo per identificare se la chiave esiste o meno nell'archivio di 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 (true
ofalse
). Questo valore specifica se la chiave esiste o meno nell'archivio dei valori della chiave.
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}