Aracılığıyla paylaş

Değeri önbellekte depolama

UYGULANANLAR: Tüm API Management katmanları

, cache-store-value önbelleğe alma işlemini anahtara göre gerçekleştirir. Anahtarın rastgele bir dize değeri olabilir ve genellikle ilke ifadesi kullanılarak sağlanır.

Not

Değeri bu ilke tarafından gerçekleştirilen önbellekte depolama işlemi zaman uyumsuzdur. Depolanan değer, Önbellek ilkesinden değer al kullanılarak alınabilir. Ancak, depolanmış değer önbellekte depolayan zaman uyumsuz işlem hala devam ediyor olabileceğinden alma için hemen kullanılamayabilir.

Ö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-store-value key="cache key value" value="value to cache" duration="seconds" 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
- externalAzure API Management'ta dış Redis için Azure Cache 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
süre Değer, saniye cinsinden belirtilen belirtilen süre değeri için önbelleğe alınır. İlke ifadelerine izin verilir. Evet Yok
anahtar Değerin altında depolanacağı önbellek anahtarı. İlke ifadelerine izin verilir. Evet Yok
değer Önbelleğe alınacak değer. İlke ifadelerine izin verilir. 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.
  • 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, önbellekte bir kullanıcı profili depolamak için ilkenin cache-store-value nasıl kullanılacağı gösterilmektedir. Önbellek girdisinin anahtarı, bir dizeyi bağlam değişkeninin enduserid değeriyle birleştiren bir ilke ifadesi kullanılarak oluşturulur.

Kullanıcı profilini önbellekten almak için bir cache-lookup-value örneğine bakın.

<cache-store-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    value="@((string)context.Variables["userprofile"])" duration="100000" />

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