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.

kebijakan cache

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.

  1. Masuk ke portal Azure.

  2. Telusuri ke instans APIM Anda.

  3. Pilih tab API.

  4. Klik Demo Conference API dari daftar API Anda.

  5. Pilih GetSpeakers.

  6. Di layar paling atas, pilih tab Desain.

  7. Di bagian Pemrosesan masuk, klik ikon </>.

    editor kode

  8. 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>
    
  9. 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.

  1. Di portal Microsoft Azure, telusuri ke instans APIM Anda.
  2. Pilih tab API.
  3. Pilih API tempat Anda menambahkan kebijakan cache.
  4. Pilih operasi GetSpeakers.
  5. Klik tab Uji di menu kanan atas.
  6. Tekan Kirim.

Langkah berikutnya