Menambahkan cache untuk meningkatkan kinerja di Azure API Management
BERLAKU UNTUK: Pengembang | Dasar | Dasar v2 | Standar | Standar v2 | Premium
API dan operasi dalam API Management dapat dikonfigurasi dengan cache respons. Cache respons dapat secara signifikan mengurangi latensi bagi pemanggil API dan muatan backend untuk penyedia API.
Penting
Cache bawaan mudah menguap dan dibagikan oleh semua unit di wilayah yang sama dalam layanan API Management yang sama. Terlepas dari jenis cache yang digunakan (internal atau eksternal), jika operasi terkait cache gagal terhubung ke cache karena volatilitas cache atau alasan lain, panggilan API yang menggunakan operasi terkait cache tidak menimbulkan kesalahan, dan operasi cache berhasil diselesaikan. Dalam kasus operasi baca, nilai null dikembalikan ke ekspresi kebijakan panggilan. Kode kebijakan Anda harus dirancang untuk memastikan bahwa ada mekanisme "fallback" untuk mengambil data yang tidak ditemukan di cache. Untuk informasi lebih terperinci mengenai cache, lihat kebijakan pembuatan cache API Management dan Pembuatan cache kustom di Azure API Management.
Yang akan Anda pelajari:
- Menambahkan cache respons untuk API Anda
- Memverifikasi cache dalam tindakan
Catatan
Cache internal tidak tersedia di tingkat Konsumsi dari Azure API Management. Sebagai gantinya, Anda dapat menggunakan Azure Cache for Redis eksternal. Anda juga dapat mengonfigurasi cache eksternal di tingkat layanan API Management lainnya.
Prasyarat
Untuk menyelesaikan tutorial ini:
Menambahkan kebijakan penembolokan
Dengan kebijakan cache yang ditunjukkan dalam contoh ini, permintaan pertama ke operasi GetSpeakers akan mengembalikan respons dari layanan backend. Respons ini kemudian di-cache, di-keyed oleh header dan parameter string kueri yang ditentukan. Panggilan selanjutnya ke operasi, dengan parameter yang sesuai, akan mengembalikan respons cache, hingga interval durasi cache kedaluwarsa.
Masuk ke portal Azure.
Telusuri ke instans APIM Anda.
Pilih tab API.
Klik Demo Conference API dari daftar API Anda.
Pilih GetSpeakers.
Di layar paling atas, pilih tab Desain.
Di bagian Pemrosesan masuk, klik ikon </>.
Di elemen masuk, tambahkan kebijakan berikut:
<cache-lookup vary-by-developer="false" vary-by-developer-groups="false"> <vary-by-header>Accept</vary-by-header> <vary-by-header>Accept-Charset</vary-by-header> <vary-by-header>Authorization</vary-by-header> </cache-lookup>
Di elemen keluar, tambahkan kebijakan berikut:
<cache-store duration="20" />
Durasi menentukan interval kedaluwarsa respons cache. Dalam contoh ini, intervalnya adalah 20 detik.
Tip
Jika Anda menggunakan cache eksternal, seperti yang dijelaskan dalam Menggunakan Azure Cache for Redis eksternal di Azure API Management, Anda mungkin ingin menentukan atribut caching-type
dari kebijakan cache. Lihat kebijakan cache API Management untuk detail selengkapnya.
Memanggil operasi dan menguji penembolokan
Untuk melihat cache yang sedang beraksi, hubungi operasi dari portal pengembang.
- Di portal Microsoft Azure, telusuri ke instans APIM Anda.
- Pilih tab API.
- Pilih API tempat Anda menambahkan kebijakan cache.
- Pilih operasi GetSpeakers.
- Klik tab Uji di menu kanan atas.
- Tekan Kirim.
Langkah berikutnya
- Untuk informasi selengkapnya tentang kebijakan cache, lihat Kebijakan pembuatan cache di dalam referensi kebijakan API Management.
- Untuk informasi tentang item pembuatan cache berdasarkan kunci menggunakan ekspresi kebijakan, lihat Pembuatan cache kustom di Azure API Management.
- Untuk informasi selengkapnya tentang menggunakan Azure Cache for Redis eksternal, lihat Menggunakan Azure Cache for Redis eksternal di Azure API Management.