Aracılığıyla paylaş

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

ŞUNLAR İÇİN GEÇERLİDİR: Geliştirici | Temel | Temel v2 | Standart | Standart v2 | Premium | Premium v2 | İZOLE

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. Bu makalede, API'lerinize önbelleğe alma ekleme işlemi açıklanmaktadır.

Önemli

Yerleşik önbellek geçicidir ve aynı API Management örneğindeki aynı bölgedeki tüm birimler tarafından paylaşılır. Kullanılan önbellek türünden bağımsız olarak (iç veya dış), önbellekle ilgili işlemler önbelleğin volatilitesi nedeniyle veya başka bir nedenle önbelleğe bağlanamazsa, önbellekle ilgili işlemi kullanan API çağrısı bir hataya neden olmaz 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.

API Management'ta önbellek ilkelerini gösteren ekran görüntüsü.

Bu makalede şunları yapabilirsiniz:

  • API'nize yanıt önbelleği ekleme
  • Önbelleğe alma işleminin çalıştığını doğrulama

Not

İç önbelleğe alma, 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

Önbelleğe alma ilkeleri ekleme

Bu örnekte gösterilen önbelleğe alma ilkeleriyle, test işlemine yapılan ilk istek 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, önbellek süresi süresi dolana kadar önbelleğe alınan yanıtı döndürür.

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

  2. API Management örneğine gidin.

  3. Soldaki menüden>API'ler API'leri'ni seçin.

  4. Önbelleğe almayı yapılandırmak istediğiniz API'yi seçin.

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

  6. Gelen işleme bölümünde /< simgesini seçin>:

    Portalda API Management API'lerini gösteren ekran görüntüsü.

  7. inbound öğesine aşağıdaki 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>

  8. outbound öğesine aşağıdaki ilkeyi ekleyin:

    <cache-store duration="20" />

    Bu ilkede, duration önbelleğe alınan yanıtların süre sonu aralığını belirtir. Aralık 20 saniyedir.

  9. Kaydetseçeneğini seçin.

İpucu

Azure API Management'ta Redis için dış Azure Önbelleği 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 bilgi için bkz. API Management önbelleğe alma ilkeleri .

Önbelleğe almayı test etmek için bir işlem çağırın

Önbelleğe almayı test etmek için portalda bir işlemi çağırın.

  1. Azure portalında API Management örneğine gidin.
  2. Soldaki menüden>API'ler API'leri'ni seçin.
  3. Önbelleğe alma ilkelerini eklediğiniz API’leri seçin.
  4. Test etmek için bir işlem seçin.
  5. Pencerenin üst kısmındaki Test sekmesini seçin.
  6. Hızlı bir şekilde iki veya üç kez İzle'yi seçin.
  7. HTTP yanıtı'nın altında İzleme sekmesini seçin.
  8. Gelen bölümüne atlayın ve ilkeye cache-lookup kaydırın. Aşağıdaki ekran görüntüsünde önbellek isabetine benzeyen bir ileti görmeniz gerekir: Portalda bir API'yi test ederken önbellek araması ekran görüntüsü.

İlgili içerik