Bekerja dengan data nilai kunci

Topik ini menjelaskan cara menambahkan pasangan nilai kunci ke penyimpanan nilai kunci yang ada. Untuk menyertakan pasangan kunci-nilai saat Anda awalnya membuat penyimpanan nilai kunci, lihat. Buat penyimpanan nilai kunci

Bekerja dengan pasangan nilai kunci (konsol)

Anda dapat menggunakan CloudFront konsol untuk bekerja dengan pasangan nilai kunci Anda.

Untuk bekerja dengan pasangan nilai kunci

1. Masuk ke AWS Management Console dan buka halaman Fungsi di CloudFront konsol dihttps://console.aws.amazon.com/cloudfront/v4/home#/functions.

2. Pilih KeyValueStorestab.

3. Pilih penyimpanan nilai kunci yang ingin Anda ubah.

4. Di bagian Pasangan nilai kunci, pilih Edit.

5. Anda dapat menambahkan pasangan kunci-nilai, menghapus pasangan kunci-nilai, atau mengubah nilai untuk pasangan kunci-nilai yang ada.

6. Setelah Anda selesai, pilih Simpan perubahan.

Tentang CloudFront KeyValueStore

Tip

CloudFront KeyValueStore APIIni 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 kredensi sementara dengan CloudFront KeyValueStore API.

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 kunci-nilai di penyimpanan nilai kunci saat Anda pertama kali membuat penyimpanan nilai kunci, gunakan layanan. CloudFront

Keduanya CloudFront API dan yang CloudFront KeyValueStore API memiliki DescribeKeyValueStore operasi. Anda memanggil mereka untuk alasan yang berbeda. Untuk memahami perbedaannya, lihat tabel berikut.

	CloudFront DescribeKeyValueStore API	CloudFront KeyValueStore DescribeKeyValueStore API
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	ETagMengembalikanUUID,, dan ARN dari penyimpanan nilai kunci.	Mengembalikan ETag dan ARN dari penyimpanan nilai kunci.

Catatan

• Setiap DescribeKeyValueStore operasi mengembalikan yang berbedaETag. Itu ETags tidak bisa dipertukarkan.

• Ketika Anda memanggil API operasi untuk menyelesaikan suatu tindakan, Anda harus menentukan ETag dari yang sesuaiAPI. Misalnya, dalam CloudFront KeyValueStore DeleteKeyoperasi, Anda menentukan ETag yang Anda kembalikan dari CloudFront KeyValueStore DescribeKeyValueStoreoperasi.

Bekerja dengan pasangan nilai kunci ()AWS CLI

Anda dapat menjalankan AWS Command Line Interface perintah berikut untuk CloudFront KeyValueStore.

Daftar Isi

• Daftar pasangan kunci-nilai
• Dapatkan pasangan nilai kunci
• Jelaskan penyimpanan nilai kunci
• Buat pasangan kunci-nilai
• Hapus pasangan kunci-nilai
• Perbarui pasangan nilai kunci

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 nilai kunci

Untuk mendapatkan pasangan nilai kunci 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 menggambarkan 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.

Daftar Isi

• Dapatkan referensi ke penyimpanan nilai kunci
• Ubah pasangan nilai kunci di penyimpanan nilai kunci
• Contoh kode untuk CloudFront KeyValueStore

Dapatkan referensi ke penyimpanan nilai kunci

Bila Anda menggunakan CloudFront KeyValueStore API untuk memanggil operasi tulis, Anda perlu menentukan ARN dan ETag dari penyimpanan nilai kunci. Untuk mendapatkan data ini, lakukan hal berikut:

Untuk mendapatkan referensi ke penyimpanan nilai kunci

1. Gunakan CloudFront ListKeyValueStoresAPIoperasi untuk mendapatkan daftar penyimpanan nilai kunci. Temukan penyimpanan nilai kunci yang ingin Anda ubah.

2. Gunakan CloudFrontKeyValueStore DescribeKeyValueStoreAPIoperasi dan tentukan penyimpanan nilai kunci dari langkah sebelumnya.

   Respons termasuk ARN dan ETag dari penyimpanan nilai kunci.

   • ARNTermasuk Akun AWS angka, konstantakey-value-store, danUUID, 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 nilai kunci di penyimpanan nilai kunci

Anda dapat menentukan penyimpanan nilai kunci yang berisi pasangan kunci-nilai yang ingin Anda perbarui.

Lihat CloudFront KeyValueStore API operasi berikut:

• CloudFrontKeyValueStore DeleteKey— Menghapus pasangan kunci-nilai

• CloudFrontKeyValueStore GetKey— Mengembalikan pasangan kunci-nilai

• CloudFrontKeyValueStore ListKeys— Mengembalikan daftar pasangan kunci-nilai

• CloudFrontKeyValueStore PutKey— 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— 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 nilai kunci baru

  • Tetapkan nilai yang berbeda dalam satu atau lebih pasangan kunci-nilai yang ada

Contoh kode untuk CloudFront KeyValueStore

Kode berikut menunjukkan cara memanggil DescribeKeyValueStore API operasi 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);
  }
})();