الحصول على قيمة من ذاكرة التخزين المؤقت
ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات
استخدم النهج cache-lookup-value لإجراء بحث في ذاكرة التخزين المؤقت بواسطة المفتاح ثم إرجاع قيمة مخزنة مؤقتًا. يمكن أن يتضمن المفتاح قيمة سلسلة إجبارية، ويتم توفيرها عادةً باستخدام التعبير عن النهج.
إشعار
يجب أن يحتوي هذا النهج على قيمة تخزين مطابق في نهج ذاكرة التخزين المؤقت.
هام
تتسم ذاكرة التخزين المؤقت المدمجة بأنها متغيرة وتتم مشاركتها من قِبل كافة الوحدات الموجودة في نفس المنطقة داخل نفس خدمة API Management.
إشعار
تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.
نهج السياسة
<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" />
سمات
| السمة | الوصف | مطلوبة | افتراضي |
|---|---|---|---|
| نوع التخزين المؤقت | الاختيار بين القيم التالية من السمة: - internal لاستخدام ذاكرة التخزين المؤقت لإدارة واجهة برمجة التطبيقات المضمنة،- external لاستخدام ذاكرة التخزين المؤقت الخارجية كما هو موضح في استخدام ذاكرة التخزين المؤقت Azure الخارجية لـ Redis في Azure API Management,- prefer-external لاستخدام ذاكرة التخزين المؤقت الخارجية إذا تم تكوينها أو ذاكرة التخزين المؤقت الداخلية خلاف ذلك.تعبيرات النهج غير مسموح بها. |
لا | prefer-external |
| القيمة الافتراضية | قيمة سيتم تخصيصها للمتغير إذا نتج عن البحث عن مفتاح ذاكرة التخزين المؤقت خطأ. إذا لم يتم تحديد هذه السمة، يتم تعيين null. يتم السماح بتعبيرات النهج. |
لا | null |
| المفتاح | قيمة مفتاح التخزين المؤقت لاستخدامها في البحث. يتم السماح بتعبيرات النهج. | نعم | غير متوفر |
| اسم المتغير | اسم متغير السياق سيتم تعيين القيمة التي تم البحث عنها إلى، إذا كان البحث ناجحًا. إذا كان البحث ينتج عن خطأ، فلن يتم تعيين المتغير. تعبيرات النهج غير مسموح بها. | نعم | غير متوفر |
الاستخدام
- أقسام النهج: واردة وصادرة وخلفية وعند الخطأ
- نطاقات النهج: العمومية، ومساحة العمل، والمنتج، وواجهة برمجة التطبيقات، والتشغيل
- البوابات: الكلاسيكية، الإصدار 2، الاستهلاك، المستضافة ذاتيا، مساحة العمل
مثال
<cache-lookup-value
key="@("userprofile-" + context.Variables["enduserid"])"
variable-name="userprofile" />
للحصول على مزيدٍ من المعلومات والأمثلة على هذا النهج، راجع التخزين المؤقت المخصص في Azure API Management.
النهج ذات الصلة
المحتوى ذو الصلة
لمزيد من المعلومات حول العمل مع النُهج، راجع: