مشاركة عبر

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

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

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، الاستهلاك، المستضافة ذاتيا، مساحة العمل

ملاحظات الاستخدام

  • تخزن APIM الاستجابات لطلبات HTTP GET مؤقتا فقط.
  • يمكن استخدام هذا النهج مرة واحدة فقط في قسم النهج.
  • نوصي بتكوين نهج حد المعدل (أو نهج حد المعدل حسب المفتاح ) مباشرة بعد أي بحث في ذاكرة التخزين المؤقت. يساعد هذا في منع تحميل خدمة الواجهة الخلفية بشكل زائد إذا لم تكن ذاكرة التخزين المؤقت متوفرة.

مثال

يوضح هذا المثال كيفية استخدام النهج cache-store-value لتخزين ملف تعريف مستخدم في ذاكرة التخزين المؤقت. يتم إنشاء مفتاح إدخال ذاكرة التخزين المؤقت باستخدام تعبير نهج يجمع بين سلسلة وقيمة enduserid متغير السياق.

راجع مثال قيمة البحث عن ذاكرة التخزين المؤقت لاسترداد ملف تعريف المستخدم من ذاكرة التخزين المؤقت.

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

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

المحتوى ذو الصلة

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

  • Last updated on