Simpan nilai dalam cache

BERLAKU UNTUK: Semua tingkatAN API Management

cache-store-value melakukan penyimpanan cache berdasarkan kunci. Kunci dapat memiliki nilai string arbitrer dan biasanya disediakan menggunakan ekspresi kebijakan.

Catatan

Operasi penyimpanan nilai dalam cache yang dilakukan oleh kebijakan ini asinkron. Nilai yang disimpan dapat diambil menggunakan kebijakan Dapatkan nilai dari cache. Namun, nilai yang disimpan mungkin tidak segera tersedia untuk diambil karena operasi asinkron yang menyimpan nilai dalam cache mungkin masih berlangsung.

Penting

Cache bawaan mudah menguap dan dibagikan oleh semua unit di wilayah yang sama dalam layanan API Management yang sama.

Catatan

Tetapkan elemen kebijakan dan elemen turunan dalam urutan yang disediakan dalam pernyataan kebijakan. Pelajari lebih lanjut cara mengatur atau mengedit kebijakan API Management.

Pernyataan kebijakan

<cache-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />

Atribut

Atribut	Deskripsi	Wajib diisi	Bawaan
jenis penembolokan	Pilih di antara nilai atribut berikut: - internal untuk menggunakan cache API Management bawaan, - external untuk menggunakan cache eksternal seperti yang dijelaskan dalam Menggunakan Azure Cache for Redis di Azure API Management, - prefer-external untuk menggunakan cache eksternal jika sebaliknya dikonfigurasi atau cache internal. Ekspresi kebijakan tidak diizinkan.	Tidak.	prefer-external
durasi	Nilai akan di-cache untuk nilai durasi yang disediakan, ditentukan dalam detik. Ekspresi kebijakan diizinkan.	Ya	T/A
kunci	Kunci cache nilai akan disimpan di bawah. Ekspresi kebijakan diizinkan.	Ya	T/A
nilai	Nilai yang akan di-cache. Ekspresi kebijakan diizinkan.	Ya	T/A

Penggunaan

• Bagian kebijakan: masuk, keluar, backend, saat terjadi kesalahan
• Cakupan kebijakan: global, ruang kerja, produk, API, operasi
• Gateway: klasik, v2, konsumsi, dihost sendiri, ruang kerja

Catatan penggunaan

• API Management hanya menyimpan respons terhadap permintaan HTTP GET.
• Kebijakan ini hanya dapat digunakan sekali di bagian kebijakan.
• Sebaiknya konfigurasikan kebijakan batas tarif (atau kebijakan batas-demi-kunci tarif ) segera setelah pencarian cache apa pun. Ini membantu menjaga agar layanan backend Anda tidak kelebihan beban jika cache tidak tersedia.

Contoh

Contoh ini menunjukkan cara menggunakan cache-store-value kebijakan untuk menyimpan profil pengguna di cache. Kunci untuk entri cache dibangun menggunakan ekspresi kebijakan yang menggabungkan string dengan nilai enduserid variabel konteks.

Lihat contoh cache-lookup-value untuk mengambil profil pengguna dari cache.

<cache-store-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    value="@((string)context.Variables["userprofile"])" duration="100000" />

Untuk informasi selengkapnya dan contoh kebijakan ini, lihat Pembuatan cache kustom di Azure API Management.

Kebijakan terkait

• Penembolokan

Konten terkait

Untuk informasi selengkapnya tentang bekerja dengan kebijakan, lihat:

• Tutorial: Mengubah dan melindungi API Anda
• Referensi Kebijakan untuk daftar lengkap pernyataan kebijakan dan pengaturannya
• Ekspresi kebijakan
• Mengatur atau mengedit kebijakan
• Menggunakan kembali konfigurasi kebijakan
• Repositori cuplikan kebijakan
• Repositori taman bermain kebijakan
• Toolkit kebijakan Azure API Management
• Mendapatkan bantuan Copilot untuk membuat, menjelaskan, dan memecahkan masalah kebijakan