Metode pembantu untuk penyimpanan nilai kunci

Bagian ini berlaku jika Anda menggunakan CloudFront Key Value Store untuk menyertakan nilai kunci dalam fungsi yang Anda buat. CloudFront Fungsi memiliki modul yang menyediakan tiga metode pembantu untuk membaca nilai dari penyimpanan nilai kunci.

Untuk menggunakan modul ini dalam kode fungsi, pastikan bahwa Anda telah mengaitkan penyimpanan nilai kunci dengan fungsi tersebut.

Selanjutnya, sertakan pernyataan berikut di baris pertama kode fungsi:

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

ID penyimpanan nilai kunci Anda mungkin terlihat seperti berikut: a1b2c3d4-5678-90ab-cdef-EXAMPLE1

Metode get()

Gunakan metode ini untuk mengembalikan nilai kunci untuk nama kunci yang Anda tentukan.

Permintaan

get("key", options);

• key: Nama kunci yang nilainya perlu diambil

• options: Ada satu pilihan,format. Ini memastikan bahwa fungsi mem-parsing data dengan benar. Kemungkinan nilai:

  • string: (Default) UTF8 dikodekan

  • json

  • bytes: Buffer data biner mentah

Minta contoh

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

Respons

Responsnya adalah promise yang menyelesaikan nilai dalam format yang diminta dengan menggunakan. options Secara default, nilai dikembalikan sebagai string.

Metode exists()

Gunakan metode ini untuk mengidentifikasi apakah kunci ada di penyimpanan nilai kunci atau tidak.

Permintaan

exists("key");

Minta contoh

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

Respons

Responsnya adalah promise yang mengembalikan Boolean (trueataufalse). Nilai ini menentukan apakah kunci ada atau tidak di penyimpanan nilai kunci.

Penanganan kesalahan

get()Metode ini akan mengembalikan kesalahan ketika kunci yang Anda minta tidak ada di penyimpanan nilai kunci terkait. Untuk mengelola kasus penggunaan ini, Anda dapat menambahkan try dan catch memblokir kode Anda.

Metode meta()

Gunakan metode ini untuk mengembalikan metadata tentang penyimpanan nilai kunci.

Permintaan

meta();

Minta contoh

const meta = await kvsHandle.meta();

Respons

Responsnya adalah promise yang menyelesaikan objek dengan properti berikut:

• creationDateTime: Tanggal dan waktu penyimpanan nilai kunci dibuat, dalam format ISO 8601.

• lastUpdatedDateTime: Tanggal dan waktu penyimpanan nilai kunci terakhir disinkronkan dari sumber, dalam format ISO 8601. Nilainya tidak termasuk waktu propagasi ke tepi.

• keyCount: Jumlah total kunci di KVS setelah sinkronisasi terakhir dari sumber.

Contoh respons

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