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