Ö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: - internal yerleşik API Management önbelleğini kullanmak için- external Azure 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 |
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. | Yes | Yok |
variable-name | 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. | Yes | Yok |
Kullanım
- İlke bölümleri: gelen, giden, arka uç, hatada
- İlke kapsamları: genel, çalışma alanı, ürün, API, işlem
- Ağ geçitleri: klasik, v2, tüketim, şirket içinde barındırılan, çalışma alanı
Örnek
<cache-lookup-value
key="@("userprofile-" + context.Variables["enduserid"])"
variable-name="userprofile" />
Bu ilke hakkında daha fazla bilgi ve örnek için bkz . Azure API Management'ta özel önbelleğe alma.
İlgili ilkeler
İlgili içerik
İlkelerle çalışma hakkında daha fazla bilgi için bkz:
- Öğretici: API'nizi dönüştürme ve koruma
- İlke deyimlerinin ve ayarlarının tam listesi için ilke başvurusu
- İlke ifadeleri
- İlkeleri ayarlama veya düzenleme
- İlke yapılandırmalarını yeniden kullanma
- İlke kod parçacıkları deposu
- Azure API Management ilke araç seti
- Azure'da Microsoft Copilot kullanarak ilke yazma