Dapatkan nilai dari cache
BERLAKU UNTUK: Semua tingkatAN API Management
Gunakan kebijakan cache-lookup-value untuk melakukan pencarian cache dengan kunci dan mengembalikan nilai cache. Kunci dapat memiliki nilai string arbitrer dan biasanya disediakan menggunakan ekspresi kebijakan.
Catatan
Kebijakan ini harus memiliki kebijakan Simpan nilai di cache yang sesuai.
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-lookup-value key="cache key value"
default-value="value to use if cache lookup resulted in a miss"
variable-name="name of a variable looked up value is assigned to"
caching-type="prefer-external | external | internal" />
Atribut
| Atribut | Deskripsi | Wajib diisi | Default |
|---|---|---|---|
| caching-type | 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. |
No | prefer-external |
| default-value | Nilai yang akan ditetapkan ke variabel jika pencarian kunci cache mengakibatkan ketinggalan. Jika atribut ini tidak ditentukan, null ditetapkan. Ekspresi kebijakan diizinkan. |
No | null |
| kunci | Nilai kunci cache untuk digunakan dalam pencarian. Ekspresi kebijakan diizinkan. | Ya | T/A |
| variable-name | Nama variabel konteks nilai pencarian akan ditetapkan, jika pencarian berhasil. Jika pencarian gagal, variabel tidak akan diatur. Ekspresi kebijakan tidak 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
Contoh
<cache-lookup-value
key="@("userprofile-" + context.Variables["enduserid"])"
variable-name="userprofile" />
Untuk informasi selengkapnya dan contoh kebijakan ini, lihat Pembuatan cache kustom di Azure API Management.
Kebijakan terkait
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
- Kebijakan penulis menggunakan Microsoft Copilot di Azure