Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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 (true
ataufalse
). 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}