Aracılığıyla paylaş

Önbellekten değer alma

UYGULANANLAR: Tüm API Management katmanları

anahtara cache-lookup-value göre önbellek araması yapmak ve önbelleğe alınmış bir değer döndürmek için ilkeyi kullanın. Anahtarın rastgele bir dize değeri olabilir ve genellikle ilke ifadesi kullanılarak sağlanır.

Not

Bu ilkenin önbellek ilkesinde karşılık gelen bir Store değerine sahip olması gerekir.

Önemli

Yerleşik önbellek geçicidir ve aynı API Management hizmetindeki aynı bölgedeki tüm birimler tarafından paylaşılır.

Not

İlkenin öğelerini ve alt öğelerini ilke bildiriminde sağlanan sırayla ayarlayın. API Management ilkelerini ayarlama veya düzenleme hakkında daha fazla bilgi edinin.

İlke bildirimi

<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" />

Özellikler

Öznitelik Açıklama Zorunlu Varsayılan
önbelleğe alma türü Özniteliğin aşağıdaki değerleri arasında seçim yapın:
- internalyerleşik API Management önbelleğini kullanmak için
- external Azure API Management'ta dış Redis uyumlu önbellek kullanma bölümünde açıklandığı gibi dış önbelleği kullanmak için,
- prefer-external yapılandırıldıysa dış önbelleği veya başka bir şekilde iç önbelleği kullanmak için.

İlke ifadelerine izin verilmez.		 Hayır prefer-external
default-value Önbellek anahtarı aramasının bir yanıtsız sonuçlanması durumunda değişkene atanacak bir değer. Bu öznitelik belirtilmezse atanır null . İlke ifadelerine izin verilir. Hayır null
anahtar Aramada kullanılacak önbellek anahtarı değeri. İlke ifadelerine izin verilir. Evet Yok
değişken-adı Arama başarılı olursa aranan değerin atanacağı bağlam değişkeninin adı. Arama sonucunda yanıt alınmazsa değişken ayarlanmaz. İlke ifadelerine izin verilmez. Evet Yok

Kullanım

Kullanım notları

  • API Management yalnızca HTTP GET isteklerine yönelik yanıtları önbelleğe alır.
  • Bu ilke, ilke bölümünde yalnızca bir kez kullanılabilir.
  • Bu ilke, bir ilke parçası içinde desteklenmez.
  • Herhangi bir önbellek aramadan hemen sonra hız sınırı ilkesi (veya anahtara göre hız sınırı ilkesi) yapılandırmanızı öneririz. Bu, önbellek kullanılamıyorsa arka uç hizmetinizin aşırı yüklenmesini engeller.

Örnek

Bu örnekte, önbellekten kullanıcı profili almak için ilkenin cache-lookup-value nasıl kullanılacağı gösterilmektedir. Önbellek araması anahtarı, bir dizeyi bağlam değişkeninin enduserid değeriyle birleştiren bir ilke ifadesi kullanılarak oluşturulur.

Not

Önbellek aramasının ardından, çağrı sayısını sınırlamaya ve önbelleğin kullanılabilir olmaması durumunda arka uç hizmetinde aşırı yüklemeyi önlemeye yardımcı olmak için bir hız sınırı ilkesi (veya anahtara göre hız sınırı ilkesi) ekleyin.

Kullanıcı profilini önbellekte depolamak için bir cache-store-value örneğine bakın.

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />
<rate-limit calls="10" renewal-period="60" />

Bu ilke hakkında daha fazla bilgi ve örnek için bkz . Azure API Management'ta özel önbelleğe alma.

İlgili içerik

İlkelerle çalışma hakkında daha fazla bilgi için bkz:

  • Last updated on