Share via


Azure API Management performansını artırmak için önbelleğe alma ekleme

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Temel | Temel v2 | Standart | Standart v2 | Premium

API Management'taki API'ler ve işlemler yanıt önbelleğe alma ile yapılandırılabilir. Yanıt önbelleği API çağrısı yapanlar için gecikme süresini ve API sağlayıcıları için arka uç yükünü önemli ölçüde azaltabilir.

Önemli

Yerleşik önbellek geçicidir ve aynı API Management hizmetindeki aynı bölgedeki tüm birimler tarafından paylaşılır. Kullanılan önbellek türünden (iç veya dış) bağımsız olarak, önbellekle ilgili işlemler önbelleğin geçici olmasından veya başka bir nedenden dolayı önbelleğe bağlanamazsa, önbellekle ilgili işlemi kullanan API çağrısı hata oluşturmaz ve önbellek işlemi başarıyla tamamlanır. Okuma işlemi söz konusu olduğunda çağrıyı yapan ilke ifadesine null bir değer döndürülür. İlke kodunuz, önbellekte bulunmayan verileri almak için bir "geri dönüş" mekanizması olduğundan emin olmak için tasarlanmalıdır. Önbelleğe alma hakkında daha ayrıntılı bilgi için bkz. API Management önbelleğe alma ilkeleri ve Azure API Management'te özel önbelleğe alma.

önbellek ilkeleri

Öğrenecekleriniz:

  • API'nize yanıt önbelleği ekleme
  • Eylem halinde önbelleğe alma işlemini doğrulama

Not

İç önbellek, Azure API Management'ın Tüketim katmanında kullanılamaz. Bunun yerine dış Redis için Azure Cache kullanabilirsiniz. Diğer API Management hizmet katmanlarında bir dış önbellek de yapılandırabilirsiniz.

Önkoşullar

Bu öğreticiyi tamamlamak için:

Önbelleğe alma ilkelerini ekleme

Bu örnekte önbelleğe alma ilkeleri kullanılarak, GetSpeakers işlemine yapılan ilk istek işlemi arka uç hizmetinden bir yanıt döndürür. Bu yanıt, belirtilen üst bilgiler ve sorgu dizesi parametreleri tarafından önbelleğe alınır ve anahtarlanır. Eşleşen parametrelerle, işleme yapılan sonraki çağrılar, önbelleğe alma süresi aralığı sona erinceye kadar, önbelleğe alınan yanıtın döndürülmesini sağlar.

  1. Azure Portal’ında oturum açın.

  2. APIM örneğinize göz atın.

  3. API sekmesini seçin.

  4. API listenizden Tanıtım Konferansı API’sine tıklayın.

  5. GetSpeakers’ı seçin.

  6. Ekranın üst kısmında Tasarım sekmesini seçin.

  7. Gelen işleme bölümünde /> simgesine <tıklayın.

    kod düzenleyicisi

  8. Gelen öğesinde, şu ilkeyi ekleyin:

    <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. Giden öğesinde, şu ilkeyi ekleyin:

    <cache-store duration="20" />
    

    Süre önbelleğe alınan yanıtların sona erme aralığını belirtir. Bu örnekte, aralık 20 saniyedir.

İpucu

Azure API Management'ta dış Redis için Azure Cache kullanma bölümünde açıklandığı gibi bir dış önbellek kullanıyorsanız, önbelleğe alma ilkelerinin özniteliğini belirtmek caching-type isteyebilirsiniz. Daha fazla ayrıntı için bkz . API Management önbelleğe alma ilkeleri .

İşlem çağırma ve önbelleğe almayı test etme

Önbelleğe alma eylemini görmek için, işlemi geliştirici portalından çağırın.

  1. Azure portalında APIM örneğinize göz atın.
  2. API'ler sekmesini seçin.
  3. Önbelleğe alma ilkelerini eklediğiniz API’leri seçin.
  4. GetSpeakers işlemini seçin.
  5. Sağ üst menüdeki Test sekmesine tıklayın.
  6. Gönder’e basın.

Sonraki adımlar