تخزين القيمة في ذاكرة التخزين المؤقت

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

cache-store-valueينفذ التخزين المؤقت بواسطة المفتاح. يمكن أن يتضمن المفتاح قيمة سلسلة إجبارية، ويتم توفيرها عادةً باستخدام التعبير عن النهج.

إشعار

عملية تخزين القيمة في ذاكرة التخزين المؤقت التي يتم تنفيذها بواسطة هذا النهج غير متزامنة. يمكن استرداد القيمة المخزنة باستخدام قيمة الحصول على من نهج ذاكرة التخزين المؤقت. ومع ذلك، قد لا تكون القيمة المخزنة متاحة على الفور للاسترداد لأن العملية غير المتزامنة التي تخزن القيمة في ذاكرة التخزين المؤقت قد لا تزال قيد التقدم.

هام

تتسم ذاكرة التخزين المؤقت المدمجة بأنها متغيرة وتتم مشاركتها من قِبل كافة الوحدات الموجودة في نفس المنطقة داخل نفس خدمة API Management.

إشعار

تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.

نهج السياسة

<cache-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />

سمات

السمة ‏‏الوصف مطلوبة افتراضي
نوع التخزين المؤقت الاختيار بين القيم التالية من السمة:
- internal لاستخدام ذاكرة التخزين المؤقت لإدارة واجهة برمجة التطبيقات المضمنة،
- external لاستخدام ذاكرة التخزين المؤقت الخارجية كما هو موضح في استخدام ذاكرة التخزين المؤقت Azure الخارجية لـ Redis في Azure API Management,
- prefer-external لاستخدام ذاكرة التخزين المؤقت الخارجية إذا تم تكوينها أو ذاكرة التخزين المؤقت الداخلية خلاف ذلك.

تعبيرات النهج غير مسموح بها.
لا prefer-external
المدة سيتم تخزين القيمة مؤقتا لقيمة المدة المتوفرة، المحددة بالثواني. يتم السماح بتعبيرات النهج. ‏‏نعم‬ غير متوفر
المفتاح مفتاح ذاكرة التخزين المؤقت سيتم تخزين القيمة تحته. يتم السماح بتعبيرات النهج. ‏‏نعم‬ غير متوفر
قيمة القيمة التي سيتم تخزينها مؤقتًا. يتم السماح بتعبيرات النهج. ‏‏نعم‬ غير متوفر

الاستخدام

  • أقسام النهج: واردة وصادرة وخلفية وعند الخطأ
  • نطاقات النهج: العمومية، ومساحة العمل، والمنتج، وواجهة برمجة التطبيقات، والتشغيل
  • البوابات: الكلاسيكية، الإصدار 2، الاستهلاك، المستضافة ذاتيا

مثال

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

للحصول على مزيدٍ من المعلومات والأمثلة على هذا النهج، راجع التخزين المؤقت المخصص في Azure API Management.

لمزيد من المعلومات حول العمل مع النُهج، راجع: