Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Amazon CloudFront KeyValueStore
CloudFront KeyValueStore adalah datastore nilai kunci latensi rendah yang aman, global, yang memungkinkan akses baca dari dalam [CloudFront Fungsi](cloudfront-functions.md), memungkinkan logika lanjutan yang dapat disesuaikan di lokasi tepi. CloudFront
Dengan CloudFront KeyValueStore, Anda membuat pembaruan untuk kode fungsi dan pembaruan data yang terkait dengan fungsi secara independen satu sama lain. Pemisahan ini menyederhanakan kode fungsi dan membuatnya mudah untuk memperbarui data tanpa perlu menyebarkan perubahan kode.
**catatan**
Untuk menggunakannya CloudFront KeyValueStore, CloudFront fungsi Anda harus menggunakan [JavaScript runtime 2.0](functions-javascript-runtime-20.md).
Berikut ini adalah prosedur umum untuk menggunakan pasangan kunci-nilai:
+ Buat toko nilai kunci, dan isi dengan satu set pasangan kunci-nilai. Anda dapat menambahkan toko nilai kunci Anda ke bucket Amazon S3 atau memasukkannya secara manual.
+ Kaitkan penyimpanan nilai kunci dengan CloudFront fungsi Anda.
+ Dalam kode fungsi Anda, gunakan nama kunci untuk mengambil nilai yang terkait dengan kunci atau untuk mengevaluasi apakah ada kunci. Untuk informasi selengkapnya tentang penggunaan pasangan kunci-nilai dalam kode fungsi, dan tentang metode pembantu, lihat. [Metode pembantu untuk penyimpanan nilai kunci](functions-custom-methods.md)
## Kasus penggunaan
Anda dapat menggunakan pasangan kunci-nilai untuk contoh berikut:
+ **Penulisan ulang atau pengalihan URL — Pasangan kunci-nilai dapat menahan penulisan** ulang atau pengalihan. URLs URLs
+ **Pengujian A/B dan bendera fitur** — Anda dapat membuat fungsi untuk menjalankan eksperimen dengan menetapkan persentase lalu lintas ke versi tertentu dari situs web Anda.
+ **Otorisasi akses** — Anda dapat menerapkan kontrol akses untuk mengizinkan atau menolak permintaan berdasarkan kriteria yang ditentukan oleh Anda dan data yang disimpan di penyimpanan nilai kunci.
## Format yang didukung untuk nilai
Anda dapat menyimpan nilai dalam pasangan kunci-nilai dalam salah satu format berikut:
+ String
+ String yang dikodekan byte
+ JSON
## Keamanan
CloudFront Fungsi dan semua data penyimpanan nilai utamanya ditangani dengan aman, sebagai berikut:
+ CloudFront mengenkripsi setiap penyimpanan nilai kunci saat istirahat dan selama transit (saat membaca atau menulis ke penyimpanan nilai kunci) saat Anda memanggil operasi [CloudFront KeyValueStore](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_Operations_Amazon_CloudFront_KeyValueStore.html)API.
+ Saat fungsi dijalankan, CloudFront dekripsi setiap pasangan kunci-nilai dalam memori di lokasi tepi. CloudFront
Untuk memulai CloudFront KeyValueStore, lihat topik berikut.
**Topics**
+ [Kasus penggunaan](#key-value-store-use-cases)
+ [Format yang didukung untuk nilai](#key-value-store-supported-formats)
+ [Keamanan](#key-value-store-security)
+ [Bekerja dengan toko nilai kunci](kvs-with-functions-kvs.md)
+ [Bekerja dengan data nilai kunci](kvs-with-functions-kvp.md)
+ Untuk informasi lebih lanjut tentang memulai CloudFront KeyValueStore, lihat posting CloudFront KeyValueStore AWS blog [Memperkenalkan Amazon](https://aws.amazon.com/blogs/aws/introducing-amazon-cloudfront-keyvaluestore-a-low-latency-datastore-for-cloudfront-functions/).
# Bekerja dengan toko nilai kunci
Anda harus membuat penyimpanan nilai kunci untuk menahan pasangan kunci-nilai yang ingin Anda gunakan di CloudFront Functions.
Setelah Anda membuat penyimpanan nilai kunci dan menambahkan pasangan kunci-nilai, Anda dapat menggunakan nilai kunci dalam kode CloudFront fungsi Anda.
Untuk memulai, lihat topik berikut:
**Topics**
+ [Buat penyimpanan nilai kunci](kvs-with-functions-create.md)
+ [Kaitkan penyimpanan nilai kunci dengan fungsi](kvs-with-functions-associate.md)
+ [Perbarui penyimpanan nilai kunci](kvs-with-functions-edit.md)
+ [Dapatkan referensi ke penyimpanan nilai kunci](kvs-with-functions-get-reference.md)
+ [Hapus penyimpanan nilai kunci](kvs-with-functions-delete.md)
+ [Format file untuk pasangan nilai kunci](kvs-with-functions-create-s3-kvp.md)
**catatan**
JavaScript Runtime 2.0 menyertakan beberapa metode pembantu untuk bekerja dengan nilai-nilai kunci dalam kode fungsi. Untuk informasi selengkapnya, lihat [Metode pembantu untuk penyimpanan nilai kunci](functions-custom-methods.md).
# Buat penyimpanan nilai kunci
Anda dapat membuat penyimpanan nilai kunci dan pasangan nilai kunci-nya secara bersamaan. Anda juga dapat membuat penyimpanan nilai kunci kosong sekarang dan kemudian menambahkan pasangan kunci-nilai nanti.
**catatan**
Jika Anda menentukan sumber data dari bucket Amazon S3, Anda harus memiliki izin `s3:GetObject` dan `s3:GetBucketLocation` izin untuk bucket tersebut. Jika Anda tidak memiliki izin ini, tidak CloudFront dapat berhasil membuat penyimpanan nilai kunci Anda.
Putuskan apakah Anda ingin menambahkan pasangan kunci-nilai pada saat yang sama ketika Anda membuat penyimpanan nilai kunci. Anda dapat mengimpor pasangan nilai kunci dengan menggunakan CloudFront konsol, CloudFront API, atau. AWS SDKs Namun, Anda hanya dapat mengimpor file pasangan nilai kunci saat Anda *awalnya* membuat penyimpanan nilai kunci.
Untuk membuat file pasangan kunci-nilai, lihat. [Format file untuk pasangan nilai kunci](kvs-with-functions-create-s3-kvp.md)
------
#### [ Console ]
**Untuk membuat penyimpanan nilai kunci**
1. Masuk ke Konsol Manajemen AWS dan buka halaman **Fungsi** di CloudFront konsol di[https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Pilih **KeyValueStores**tab, lalu pilih **Buat KeyValueStore**.
1. Masukkan nama dan deskripsi opsional untuk penyimpanan nilai kunci.
1. **URI S3** lengkap:
+ Jika Anda memiliki file pasangan nilai kunci, masukkan path ke bucket Amazon S3 tempat Anda menyimpan file.
+ Biarkan bidang ini kosong jika Anda berencana memasukkan pasangan kunci-nilai secara manual.
1. Pilih **Buat**. Penyimpanan nilai kunci sekarang ada.
Halaman detail untuk penyimpanan nilai kunci baru muncul. Informasi pada halaman termasuk ID dan ARN dari penyimpanan nilai kunci.
+ ID adalah string acak karakter yang unik di Anda Akun AWS.
+ ARN memiliki sintaks ini:
*Akun AWS*`:key-value-store/`*the key value stores ID*
1. Lihatlah bagian **Pasangan nilai kunci**. Jika Anda mengimpor file, bagian ini menunjukkan beberapa pasangan kunci-nilai. Anda dapat melakukan tindakan berikut:
+ Jika Anda mengimpor file, Anda juga dapat menambahkan lebih banyak nilai secara manual.
+ Jika Anda tidak mengimpor file dari bucket Amazon S3, dan jika Anda ingin menambahkan pasangan nilai kunci sekarang, Anda dapat menyelesaikan langkah berikutnya.
+ Anda dapat melewati langkah ini dan menambahkan pasangan kunci-nilai nanti.
1. Untuk menambahkan pasangan sekarang:
1. Pilih **Tambahkan pasangan kunci-nilai**.
1. Pilih **Tambah pasangan** dan masukkan nama dan nilai. Ulangi langkah ini untuk menambahkan lebih banyak pasangan.
1. Setelah selesai, pilih **Simpan perubahan** untuk menyimpan semua pasangan nilai kunci di penyimpanan nilai kunci. Pada kotak dialog yang muncul, pilih **Selesai**.
1. Untuk mengaitkan penyimpanan nilai kunci dengan fungsi sekarang, selesaikan bagian **Fungsi terkait**. Untuk informasi selengkapnya, lihat [Buat fungsi](create-function.md) atau [Perbarui fungsi](update-function.md).
Anda juga dapat mengaitkan fungsi nanti, baik dari halaman detail penyimpanan nilai kunci ini, atau dari halaman detail fungsi.
------
#### [ AWS CLI ]
**Untuk membuat penyimpanan nilai kunci**
+ Jalankan perintah berikut untuk membuat penyimpanan nilai kunci dan mengimpor pasangan nilai kunci dari bucket Amazon S3.
```
aws cloudfront create-key-value-store \
--name=keyvaluestore1 \
--comment="This is my key value store file" \
--import-source=SourceType=S3,SourceARN=arn:aws:s3:::amzn-s3-demo-bucket1/kvs-input.json
```
**Respons**
```
{
"ETag": "ETVABCEXAMPLE",
"Location": "https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"KeyValueStore": {
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"Comment": "This is my key value store file",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "PROVISIONING",
"LastModifiedTime": "2024-08-06T22:19:10.813000+00:00"
}
}
```
------
#### [ API ]
**Untuk membuat penyimpanan nilai kunci**
1. Gunakan [CloudFrontCreateKeyValueStore](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateKeyValueStore.html)operasi. Operasi ini membutuhkan beberapa parameter:
+ A `name` dari penyimpan nilai kunci.
+ `comment`Parameter yang menyertakan komentar.
+ `import-source`Parameter yang memungkinkan Anda mengimpor pasangan nilai kunci dari file yang disimpan di bucket Amazon S3. Anda dapat mengimpor dari file hanya ketika Anda pertama kali membuat penyimpanan nilai kunci. Untuk informasi tentang struktur file, lihat[Format file untuk pasangan nilai kunci](kvs-with-functions-create-s3-kvp.md).
Respons operasi mencakup informasi berikut:
+ Nilai yang diteruskan dalam permintaan, termasuk nama yang Anda tetapkan.
+ Data seperti waktu pembuatan.
+ Sebuah `ETag` (misalnya,`ETVABCEXAMPLE`), ARN yang menyertakan nama penyimpanan nilai kunci (misalnya,`arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1`).
Anda akan menggunakan beberapa kombinasi dari`ETag`, ARN, dan nama untuk bekerja dengan penyimpanan nilai kunci secara terprogram.
------
## Status penyimpanan nilai kunci
Saat Anda membuat penyimpanan nilai kunci, penyimpanan data dapat memiliki nilai status berikut.
****
| Nilai | Deskripsi |
| --- | --- |
| **Penyediaan** | Penyimpanan nilai kunci telah dibuat dan CloudFront sedang memproses sumber data yang Anda tentukan. |
| **Siap** | Penyimpanan nilai kunci dibuat dan CloudFront berhasil memproses sumber data yang Anda tentukan. |
| **Impor gagal** | CloudFront tidak dapat memproses sumber data yang Anda tentukan. Status ini dapat muncul jika format file Anda tidak valid atau melebihi batas ukuran. Untuk informasi selengkapnya, lihat [Format file untuk pasangan nilai kunci](kvs-with-functions-create-s3-kvp.md). |
# Kaitkan penyimpanan nilai kunci dengan fungsi
Setelah Anda membuat penyimpanan nilai kunci Anda, Anda dapat memperbarui fungsi Anda untuk mengaitkannya dengan penyimpanan nilai kunci Anda. Anda harus membuat asosiasi ini untuk menggunakan pasangan kunci-nilai dari toko itu dalam fungsi itu. Aturan-aturan berikut berlaku:
+ Sebuah fungsi hanya dapat memiliki satu penyimpanan nilai kunci
+ Anda dapat mengaitkan penyimpanan nilai kunci yang sama dengan beberapa fungsi
------
#### [ Console ]
**Untuk mengaitkan penyimpanan nilai kunci dengan fungsi**
1. Masuk ke CloudFront konsol di [https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions) dan pilih halaman **Fungsi**.
1. Pilih nama fungsi.
1. Buka KeyValueStore bagian **Associate** dan pilih **Associate existing KeyValueStore**.
1. **Pilih penyimpanan nilai kunci yang berisi pasangan kunci-nilai dalam fungsi, lalu pilih Associate. KeyValueStore**
CloudFront segera mengaitkan toko dengan fungsinya. Anda tidak perlu menyimpan fungsinya.
1. Untuk menentukan penyimpanan nilai kunci yang berbeda, pilih **Perbarui terkait KeyValueStore**, pilih nama penyimpanan nilai kunci lainnya, lalu pilih **Associate KeyValueStore**.
Untuk informasi selengkapnya, lihat [Perbarui fungsi](update-function.md).
------
#### [ AWS CLI ]
**Untuk mengaitkan penyimpanan nilai kunci dengan fungsi**
+ Jalankan perintah berikut untuk memperbarui `MaxAge` fungsi dan mengaitkan sumber daya penyimpanan nilai kunci.
```
aws cloudfront update-function \
--name MaxAge \
--function-config '{"Comment":"Max Age 2 years","Runtime":"cloudfront-js-2.0","KeyValueStoreAssociations":{"Quantity":1,"Items":[{"KeyValueStoreARN":"arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example"}]}}' \
--function-code fileb://function-max-age-v1.js \
--if-match ETVABCEXAMPLE
```
+ Untuk mengaitkan penyimpanan nilai kunci dengan fungsi, tentukan `KeyValueStoreAssociations` parameter dan nilai kunci menyimpan ARN.
+ Untuk mengubah asosiasi, tentukan ARN penyimpanan nilai kunci lainnya.
+ Untuk menghapus asosiasi, hapus `KeyValueStoreAssociations` parameter.
Untuk informasi selengkapnya, lihat [Perbarui fungsi](update-function.md).
------
#### [ API ]
**Untuk mengaitkan penyimpanan nilai kunci dengan fungsi**
+ Gunakan Operasi API [UpdateFunction](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateFunction.html). Untuk informasi selengkapnya, lihat [Perbarui fungsi](update-function.md).
------
**Catatan**
Jika Anda memodifikasi penyimpanan nilai kunci tanpa mengubah pasangan nilai kunci, atau jika Anda hanya memodifikasi pasangan nilai kunci di penyimpanan nilai kunci, Anda tidak perlu mengaitkan penyimpanan nilai kunci lagi. Anda juga tidak perlu mempublikasikan ulang fungsinya.
Namun, kami menyarankan Anda menguji fungsi untuk memverifikasi bahwa itu berfungsi seperti yang diharapkan. Untuk informasi selengkapnya, lihat [Fungsi uji](test-function.md).
Anda dapat melihat semua fungsi yang menggunakan penyimpanan nilai kunci tertentu. Di CloudFront konsol, pilih halaman detail penyimpanan nilai kunci.
# Perbarui penyimpanan nilai kunci
Saat memperbarui penyimpanan nilai kunci, Anda dapat mengubah pasangan nilai kunci, atau mengubah asosiasi antara penyimpanan nilai kunci dan fungsi.
------
#### [ Console ]
**Untuk memperbarui penyimpanan nilai kunci**
1. Masuk ke Konsol Manajemen AWS dan buka halaman **Fungsi** di CloudFront konsol di[https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Pilih **KeyValueStores**tab.
1. Pilih penyimpanan nilai kunci yang ingin Anda perbarui.
+ Untuk memperbarui pasangan kunci-nilai, pilih **Edit** di bagian **Pasangan nilai kunci**. Anda dapat menambahkan atau menghapus pasangan kunci-nilai apa pun. Anda juga dapat mengubah nilai untuk pasangan kunci-nilai yang ada. Setelah Anda selesai, pilih **Simpan perubahan**.
+ Untuk memperbarui asosiasi untuk penyimpanan nilai kunci ini, pilih **Buka fungsi**. Untuk informasi selengkapnya, lihat [Kaitkan penyimpanan nilai kunci dengan fungsi](kvs-with-functions-associate.md).
------
#### [ AWS CLI ]
**Untuk memperbarui penyimpanan nilai kunci**
1. **Mengubah pasangan kunci-nilai** — Anda dapat menambahkan lebih banyak pasangan kunci-nilai, menghapus satu atau beberapa pasangan kunci-nilai, dan mengubah nilai pasangan kunci-nilai yang ada. Untuk informasi selengkapnya, lihat [Bekerja dengan data nilai kunci](kvs-with-functions-kvp.md).
1. **Mengubah asosiasi fungsi untuk penyimpanan nilai kunci** — Untuk memperbarui fungsi asosiasi untuk penyimpanan nilai kunci, lihat[Kaitkan penyimpanan nilai kunci dengan fungsi](kvs-with-functions-associate.md).
**Tip**
Anda akan membutuhkan ARN dari toko nilai kunci. Untuk informasi selengkapnya, lihat [Dapatkan referensi ke penyimpanan nilai kunci](kvs-with-functions-get-reference.md).
------
#### [ API ]
**Untuk memperbarui penyimpanan nilai kunci**
1. **Mengubah pasangan kunci-nilai** — Anda dapat menambahkan lebih banyak pasangan kunci-nilai, menghapus satu atau beberapa pasangan kunci-nilai, dan mengubah nilai pasangan kunci-nilai yang ada. Untuk informasi selengkapnya, lihat [Bekerja dengan data nilai kunci](kvs-with-functions-kvp.md).
1. **Mengubah asosiasi fungsi untuk penyimpanan nilai kunci** — Untuk memperbarui asosiasi fungsi untuk penyimpanan nilai kunci, gunakan operasi [UpdateFunction](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateFunction.html)API. Untuk informasi selengkapnya, lihat [Perbarui fungsi](update-function.md).
**Tip**
Anda akan membutuhkan ARN dari toko nilai kunci. Untuk informasi selengkapnya, lihat [Dapatkan referensi ke penyimpanan nilai kunci](kvs-with-functions-get-reference.md).
------
# Dapatkan referensi ke penyimpanan nilai kunci
Untuk bekerja dengan toko nilai kunci secara terprogram, Anda memerlukan `ETag` dan nama penyimpanan nilai kunci.
Untuk mendapatkan kedua nilai tersebut, Anda dapat menggunakan AWS Command Line Interface (AWS CLI) atau CloudFront API.
------
#### [ AWS CLI ]
**Untuk mendapatkan referensi penyimpanan nilai kunci**
1. Untuk mengembalikan daftar penyimpanan nilai kunci, jalankan perintah berikut Temukan nama penyimpanan nilai kunci yang ingin Anda ubah.
```
aws cloudfront list-key-value-stores
```
1. Dari respons, temukan nama penyimpanan nilai kunci yang Anda inginkan.
**Respons**
```
{
"KeyValueStoreList": {
"Items": [
{
"Name": "keyvaluestore3",
"Id": "37435e19-c205-4271-9e5c-example3",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example3",
"Status": "READY",
"LastModifiedTime": "2024-05-08T14:50:18.876000+00:00"
},
{
"Name": "keyvaluestore2",
"Id": "47970d59-6408-474d-b850-example2",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/47970d59-6408-474d-b850-example2",
"Status": "READY",
"LastModifiedTime": "2024-05-30T21:06:22.113000+00:00"
},
{
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "READY",
"LastModifiedTime": "2024-08-06T22:19:30.510000+00:00"
}
]
}
}
```
1. Jalankan perintah berikut untuk mengembalikan `ETag` untuk penyimpanan nilai kunci yang ditentukan.
```
aws cloudfront describe-key-value-store \
--name=keyvaluestore1
```
**Respons**
```
{
"ETag": "E3UN6WX5RRO2AG",
"KeyValueStore": {
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"Comment": "This is an example KVS",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "READY",
"LastModifiedTime": "2024-08-06T22:19:30.510000+00:00"
}
}
```
------
#### [ API ]
**Untuk mendapatkan referensi penyimpanan nilai kunci**
1. Gunakan operasi [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html)API untuk mengembalikan daftar penyimpanan nilai kunci. Temukan nama penyimpanan nilai kunci yang ingin Anda ubah.
1. Gunakan operasi [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DescribeKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DescribeKeyValueStore.html)API dan tentukan nama penyimpanan nilai kunci yang Anda kembalikan dari langkah sebelumnya.
------
Respons termasuk UUID, ARN dari penyimpanan nilai kunci, dan penyimpanan nilai kunci. `ETag`
+ An`ETag`, seperti `E3UN6WX5RRO2AG`
+ UUID adalah 128 bit, seperti `8aa76c93-3198-462c-aaf6-example`
+ ARN mencakup Akun AWS angka, konstanta`key-value-store`, dan UUID, seperti contoh berikut:
`arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example`
Untuk informasi lebih lanjut tentang `DescribeKeyValueStore` operasi, lihat[Tentang CloudFront KeyValueStore](kvs-with-functions-kvp.md#kvs-with-functions-api-describe).
# Hapus penyimpanan nilai kunci
Anda dapat menghapus penyimpanan nilai kunci Anda dengan menggunakan CloudFront konsol Amazon atau API.
------
#### [ Console ]
**Untuk menghapus penyimpanan nilai kunci**
1. Masuk ke Konsol Manajemen AWS dan buka halaman **Fungsi** di CloudFront konsol di[https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Pilih nama fungsi.
1. Di bawah KeyValueStore bagian **Terkait**, verifikasi apakah penyimpanan nilai kunci dikaitkan dengan fungsi tersebut. Jika ya, hapus asosiasi dengan memilih **Disassociate KeyValueStore** dan kemudian pilih **Hapus asosiasi**.
1. Di panel navigasi, pilih halaman **Fungsi** dan kemudian pilih **KeyValueStores**tab.
1. Pilih penyimpanan nilai kunci yang ingin Anda hapus dan kemudian pilih **Hapus**.
------
#### [ AWS CLI ]
**Untuk menghapus penyimpanan nilai kunci**
1. Dapatkan `ETag` dan nama toko nilai kunci. Untuk informasi selengkapnya, lihat [Dapatkan referensi ke penyimpanan nilai kunci](kvs-with-functions-get-reference.md).
1. Verifikasi apakah penyimpanan nilai kunci dikaitkan dengan fungsi. Jika ya, hapus asosiasi. Untuk informasi lebih lanjut tentang kedua langkah ini, lihat[Perbarui fungsi](update-function.md).
1. Setelah Anda memiliki nama dan `ETag` penyimpanan nilai kunci dan tidak lagi terkait dengan fungsi, Anda dapat menghapusnya.
Jalankan perintah berikut untuk menghapus penyimpanan nilai kunci yang ditentukan.
```
aws cloudfront delete-key-value-store \
--name=keyvaluestore1 \
--if-match=E3UN6WX5RRO2AG
```
------
#### [ API ]
**Untuk menghapus penyimpanan nilai kunci**
1. Dapatkan `ETag` dan nama toko nilai kunci. Untuk informasi selengkapnya, lihat [Dapatkan referensi ke penyimpanan nilai kunci](kvs-with-functions-get-reference.md).
1. Verifikasi apakah penyimpanan nilai kunci dikaitkan dengan fungsi. Jika ya, hapus asosiasi. Untuk informasi lebih lanjut tentang kedua langkah ini, lihat[Perbarui fungsi](update-function.md).
1. Untuk menghapus penyimpanan nilai kunci, gunakan operasi CloudFront [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteKeyValueStore.html)API.
------
# Format file untuk pasangan nilai kunci
Saat Anda membuat file yang dikodekan UTF-8, gunakan format JSON berikut:
```
{
"data":[
{
"key":"key1",
"value":"value"
},
{
"key":"key2",
"value":"value"
}
]
}
```
File Anda tidak dapat menyertakan kunci duplikat. Jika Anda menentukan file yang tidak valid di bucket Amazon S3, Anda dapat memperbarui file tersebut untuk menghapus duplikat apa pun dan kemudian mencoba membuat penyimpanan nilai kunci Anda lagi.
Untuk informasi selengkapnya, lihat [Buat penyimpanan nilai kunci](kvs-with-functions-create.md).
**catatan**
File untuk sumber data Anda dan pasangan nilai kunci-nya memiliki batasan berikut:
Ukuran file — 5 MB
Ukuran kunci - 512 karakter
Ukuran nilai - 1024 karakter
# Bekerja dengan data nilai kunci
Topik ini menjelaskan cara menambahkan pasangan kunci-nilai ke penyimpanan nilai kunci yang ada. Untuk menyertakan pasangan kunci-nilai saat Anda awalnya membuat penyimpanan nilai kunci, lihat. [Buat penyimpanan nilai kunci](kvs-with-functions-create.md)
**Topics**
+ [Bekerja dengan pasangan nilai kunci (konsol)](#kvs-with-functions-kvp-using-console)
+ [Tentang CloudFront KeyValueStore](#kvs-with-functions-api-describe)
+ [Bekerja dengan pasangan nilai kunci ()AWS CLI](#work-with-kvs-cli-keys)
+ [Bekerja dengan pasangan nilai kunci (API)](#kvs-with-functions-kvp-using-api)
## Bekerja dengan pasangan nilai kunci (konsol)
Anda dapat menggunakan CloudFront konsol untuk bekerja dengan pasangan nilai kunci Anda.
**Untuk bekerja dengan pasangan kunci-nilai**
1. Masuk ke Konsol Manajemen AWS dan buka halaman **Fungsi** di CloudFront konsol di[https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Pilih **KeyValueStores**tab.
1. Pilih penyimpanan nilai kunci yang ingin Anda ubah.
1. Di bagian **Pasangan nilai kunci**, pilih **Edit**.
1. Anda dapat menambahkan pasangan kunci-nilai, menghapus pasangan kunci-nilai, atau mengubah nilai untuk pasangan kunci-nilai yang ada.
1. Setelah Anda selesai, pilih **Simpan perubahan**.
## Tentang CloudFront KeyValueStore
**Tip**
CloudFront KeyValueStore API adalah layanan global yang menggunakan Signature Version 4A (Sigv4a) untuk otentikasi. Menggunakan kredensi sementara dengan Sigv4a memerlukan token sesi versi 2. Untuk informasi selengkapnya, lihat [Menggunakan kredensil sementara dengan API CloudFront KeyValueStore](cloudfront-function-restrictions.md#regional-endpoint-for-key-value-store).
Jika Anda menggunakan AWS Command Line Interface (AWS CLI) atau kode Anda sendiri untuk memanggil CloudFront KeyValueStore API, lihat bagian berikut.
Saat Anda bekerja dengan penyimpan nilai kunci dan pasangan nilai kunci-nya, layanan yang Anda panggil bergantung pada kasus penggunaan Anda:
+ Untuk bekerja dengan pasangan nilai kunci di penyimpanan nilai kunci yang *ada*, gunakan layanan. CloudFront KeyValueStore
+ Untuk menyertakan pasangan nilai kunci di penyimpanan nilai kunci saat Anda *pertama kali* membuat penyimpanan nilai kunci, gunakan layanan. CloudFront
Baik CloudFront API dan CloudFront KeyValueStore API memiliki `DescribeKeyValueStore` operasi. Anda memanggil mereka untuk alasan yang berbeda. Untuk memahami perbedaannya, lihat tabel berikut.
| | API CloudFront DescribeKeyValueStore | API CloudFront KeyValueStore DescribeKeyValueStore |
| --- | --- | --- |
| Data tentang penyimpanan nilai kunci | Mengembalikan data, seperti status dan tanggal penyimpanan nilai kunci itu sendiri terakhir diubah. | Mengembalikan data tentang *isi* sumber daya penyimpanan — pasangan kunci-nilai di toko, dan ukuran konten. |
| Data yang mengidentifikasi penyimpanan nilai kunci | Mengembalikan`ETag`, UUID, dan ARN dari penyimpanan nilai kunci. | Mengembalikan `ETag` dan ARN dari penyimpanan nilai kunci. |
**Catatan**
Setiap DescribeKeyValueStore operasi mengembalikan yang *berbeda*`ETag`. Itu `ETags` tidak bisa dipertukarkan.
Saat Anda memanggil operasi API untuk menyelesaikan suatu tindakan, Anda harus menentukan `ETag` dari API yang sesuai. Misalnya, dalam CloudFront KeyValueStore [ DeleteKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DeleteKey.html)operasi, Anda menentukan `ETag` yang Anda kembalikan dari CloudFront KeyValueStore [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html)operasi.
Saat Anda memanggil CloudFront Fungsi dengan menggunakan CloudFront KeyValueStore, nilai di penyimpanan nilai kunci tidak diperbarui atau diubah selama pemanggilan fungsi. Pembaruan diproses di antara pemanggilan fungsi.
## Bekerja dengan pasangan nilai kunci ()AWS CLI
Anda dapat menjalankan AWS Command Line Interface perintah berikut untuk CloudFront KeyValueStore.
**Contents**
+ [Daftar pasangan kunci-nilai](#kvs-cli-list-keys)
+ [Dapatkan pasangan kunci-nilai](#kvs-cli-get-keys)
+ [Jelaskan penyimpanan nilai kunci](#kvs-cli-describe-keys)
+ [Buat pasangan kunci-nilai](#kvs-cli-create-keys)
+ [Hapus pasangan kunci-nilai](#kvs-cli-delete-keys)
+ [Perbarui pasangan nilai kunci](#kvs-cli-update-key)
### Daftar pasangan kunci-nilai
Untuk membuat daftar pasangan kunci-nilai di penyimpanan nilai kunci Anda, jalankan perintah berikut.
```
aws cloudfront-keyvaluestore list-keys \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Respons**
```
{
"Items": [
{
"Key": "key1",
"Value": "value1"
}
]
}
```
### Dapatkan pasangan kunci-nilai
Untuk mendapatkan pasangan kunci-nilai di penyimpanan nilai kunci Anda, jalankan perintah berikut.
```
aws cloudfront-keyvaluestore get-key \
--key=key1 \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Respons**
```
{
"Key": "key1",
"Value": "value1",
"ItemCount": 1,
"TotalSizeInBytes": 11
}
```
### Jelaskan penyimpanan nilai kunci
Untuk mendeskripsikan penyimpanan nilai kunci, jalankan perintah berikut.
```
aws cloudfront-keyvaluestore describe-key-value-store \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Respons**
```
{
"ETag": "KV1F83G8C2ARO7P",
"ItemCount": 1,
"TotalSizeInBytes": 11,
"KvsARN": "arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example",
"Created": "2024-05-08T07:48:45.381000-07:00",
"LastModified": "2024-08-05T13:50:58.843000-07:00",
"Status": "READY"
}
```
### Buat pasangan kunci-nilai
Untuk membuat pasangan kunci-nilai di penyimpanan nilai kunci Anda, jalankan perintah berikut.
```
aws cloudfront-keyvaluestore put-key \
--if-match=KV1PA6795UKMFR9 \
--key=key2 \
--value=value2 \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Respons**
```
{
"ETag": "KV13V1IB3VIYZZH",
"ItemCount": 3,
"TotalSizeInBytes": 31
}
```
### Hapus pasangan kunci-nilai
Untuk menghapus pasangan kunci-nilai, jalankan perintah berikut.
```
aws cloudfront-keyvaluestore delete-key \
--if-match=KV13V1IB3VIYZZH \
--key=key1 \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example
```
**Keluaran**
```
{
"ETag": "KV1VC38T7YXB528",
"ItemCount": 2,
"TotalSizeInBytes": 22
}
```
### Perbarui pasangan nilai kunci
Anda dapat menggunakan `update-keys` perintah untuk memperbarui lebih dari satu pasangan kunci-nilai. Misalnya, untuk menghapus pasangan kunci-nilai yang ada dan membuat yang lain, jalankan perintah berikut.
```
aws cloudfront-keyvaluestore update-keys \
--if-match=KV2EUQ1WTGCTBG2 \
--kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example \
--deletes '[{"Key":"key2"}]' \
--puts '[{"Key":"key3","Value":"value3"}]'
```
**Respons**
```
{
"ETag": "KV3AEGXETSR30VB",
"ItemCount": 3,
"TotalSizeInBytes": 28
}
```
## Bekerja dengan pasangan nilai kunci (API)
Ikuti bagian ini untuk bekerja dengan pasangan nilai kunci Anda secara terprogram.
**Contents**
+ [Dapatkan referensi ke penyimpanan nilai kunci](#kvs-with-functions-api-ref)
+ [Ubah pasangan kunci-nilai di penyimpanan nilai kunci](#kvs-with-functions-api-actions)
+ [Contoh kode untuk CloudFront KeyValueStore](#example-code-key-value-store)
### Dapatkan referensi ke penyimpanan nilai kunci
Saat Anda menggunakan CloudFront KeyValueStore API untuk memanggil operasi tulis, Anda perlu menentukan ARN dan penyimpanan `ETag` nilai kunci. Untuk mendapatkan data ini, lakukan hal berikut:
**Untuk mendapatkan referensi ke penyimpanan nilai kunci**
1. Gunakan operasi [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html)API untuk mendapatkan daftar penyimpanan nilai kunci. Temukan penyimpanan nilai kunci yang ingin Anda ubah.
1. Gunakan [operasi CloudFrontKeyValueStore DescribeKeyValueStore API](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html) dan tentukan penyimpanan nilai kunci dari langkah sebelumnya.
Respons termasuk ARN dan penyimpanan `ETag` nilai kunci.
+ ARN mencakup Akun AWS angka, konstanta`key-value-store`, dan UUID, seperti contoh berikut:
`arn:aws:cloudfront::123456789012:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`
+ An `ETag` yang terlihat seperti contoh berikut:
`ETVABCEXAMPLE2`
### Ubah pasangan kunci-nilai di penyimpanan nilai kunci
Anda dapat menentukan penyimpanan nilai kunci yang berisi pasangan kunci-nilai yang ingin Anda perbarui.
Lihat operasi CloudFront KeyValueStore API berikut:
+ [CloudFrontKeyValueStore DeleteKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DeleteKey.html)— Menghapus pasangan kunci-nilai
+ [CloudFrontKeyValueStore GetKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_GetKey.html)— Mengembalikan pasangan kunci-nilai
+ [CloudFrontKeyValueStore ListKeys](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_ListKeys.html)— Mengembalikan daftar pasangan kunci-nilai
+ [CloudFrontKeyValueStore PutKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_PutKey.html)— Anda dapat melakukan tugas-tugas berikut:
+ Buat pasangan kunci-nilai dalam satu penyimpanan nilai kunci dengan menentukan nama dan nilai kunci baru.
+ Tetapkan nilai yang berbeda dalam pasangan kunci-nilai yang ada dengan menentukan nama kunci yang ada, dan nilai kunci baru.
+ [CloudFrontKeyValueStore UpdateKeys](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_UpdateKeys.html)— Anda dapat melakukan satu atau lebih tindakan berikut dalam satu all-or-nothing operasi:
+ Hapus satu atau lebih pasangan nilai kunci
+ Buat satu atau lebih pasangan kunci-nilai baru
+ Tetapkan nilai yang berbeda dalam satu atau lebih pasangan kunci-nilai yang ada
### Contoh kode untuk CloudFront KeyValueStore
**Example**
Kode berikut menunjukkan cara memanggil operasi `DescribeKeyValueStore` API untuk penyimpanan nilai kunci.
```
const {
CloudFrontKeyValueStoreClient,
DescribeKeyValueStoreCommand,
} = require("@aws-sdk/client-cloudfront-keyvaluestore");
require("@aws-sdk/signature-v4-crt");
(async () => {
try {
const client = new CloudFrontKeyValueStoreClient({
region: "us-east-1"
});
const input = {
KvsARN: "arn:aws:cloudfront::123456789012:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
};
const command = new DescribeKeyValueStoreCommand(input);
const response = await client.send(command);
} catch (e) {
console.log(e);
}
})();
```