Hilfsmethoden für Schlüsselwertspeicher

Dieser Abschnitt gilt, wenn Sie den CloudFront Key Value Store verwenden, um Schlüsselwerte in die von Ihnen erstellte Funktion aufzunehmen. CloudFront Functions verfügt über ein Modul, das drei Hilfsmethoden zum Lesen von Werten aus dem Schlüsselwertspeicher bereitstellt.

Um dieses Modul im Funktionscode zu verwenden, stellen Sie sicher, dass Sie der Funktion einen Schlüsselwertspeicher zugeordnet haben.

Fügen Sie als Nächstes die folgenden Anweisungen in die ersten Zeilen des Funktionscodes ein:

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

Ihre key value store ID könnte wie folgt aussehen: a1b2c3d4-5678-90ab-cdef-EXAMPLE1

get()-Methode

Verwenden Sie diese Methode, um den Schlüsselwert für den von Ihnen angegebenen Schlüsselnamen zurückzugeben.

Anforderung

get("key", options);

• key: Der Name des Schlüssels, dessen Wert abgerufen werden muss

• options: Es gibt eine Option,format. Diese stellt sicher, dass die Funktion die Daten korrekt analysiert. Mögliche Werte:

  • string: (Standard) UTF8 codiert

  • json

  • bytes: Roher Binärdatenpuffer

Beispiel anfordern

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

Antwort

Die Antwort ist einepromise, die zu einem Wert in dem von using options angeforderten Format aufgelöst wird. Standardmäßig wird der Wert als Zeichenfolge zurückgegeben.

Fehlerbehandlung

Die get() Methode gibt einen Fehler zurück, wenn der von Ihnen angeforderte Schlüssel nicht im zugehörigen Schlüsselwertspeicher vorhanden ist. Um diesen Anwendungsfall zu verwalten, können Sie Ihrem Code einen try catch UND-Block hinzufügen.

exists()-Methode

Verwenden Sie diese Methode, um festzustellen, ob der Schlüssel im Schlüsselwertspeicher vorhanden ist oder nicht.

Anforderung

exists("key");

Beispiel anfordern

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

Antwort

Die Antwort ist apromise, die einen booleschen Wert (trueoderfalse) zurückgibt. Dieser Wert gibt an, ob der Schlüssel im Schlüsselwertspeicher vorhanden ist oder nicht.

meta()-Methode

Verwenden Sie diese Methode, um Metadaten über den Schlüsselwertspeicher zurückzugeben.

Anforderung

meta();

Beispiel anfordern

const meta = await kvsHandle.meta();

Antwort

Die Antwort ist ein promise, das in ein Objekt mit den folgenden Eigenschaften aufgelöst wird:

• creationDateTime: Datum und Uhrzeit der Erstellung des Schlüsselwertspeichers im ISO 8601-Format.

• lastUpdatedDateTime: Datum und Uhrzeit der letzten Synchronisierung des Schlüsselwertspeichers mit der Quelle im ISO 8601-Format. Der Wert beinhaltet nicht die Ausbreitungszeit bis zum Edge.

• keyCount: Die Gesamtzahl der Schlüssel KVS nach der letzten Synchronisierung von der Quelle.

Beispiel für eine Antwort

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