استخدام ذاكرة تخزين مؤقت خارجية متوافقة مع Redis فيAPIM

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

بالإضافة إلى استخدام ذاكرة التخزين المؤقت المضمنة، تسمح Azure API Management بالتخزين المؤقت للاستجابات في ذاكرة تخزين مؤقت خارجية متوافقة مع Redis، مثل Azure Managed Redis.

يتيح لك استخدام ذاكرة تخزين مؤقت خارجية التغلب على بعض قيود ذاكرة التخزين المؤقت المضمنة:

• تجنب مسح ذاكرة التخزين المؤقت بشكل دوري أثناء تحديثات APIM
• تمتع بمزيد من التحكم في تكوين ذاكرة التخزين المؤقت
• تخزين بيانات أكثر مما تسمح به طبقة APIM
• استخدم التخزين المؤقت مع طبقة الاستهلاك لـAPIM
• تمكين التخزين المؤقت في بوابة APIM ذاتية الاستضافة

للحصول على خلفية وسيناريوهات للتخزين المؤقت، راجع نظرة عامة على التخزين المؤقت.

للمزيد من المعلومات التفصيلية حول التخزين المؤقت، راجع سياسات APIM للتخزين المؤقت و التخزين المؤقت المخصص في APIM.

إشعار

حاليا، هذه الميزة غير متوفرة في مساحات العمل.

ستتعلم كيفية:

• إضافة ذاكرة تخزين مؤقت خارجية في APIM

المتطلبات الأساسية

لإكمال هذا البرنامج التعليمي، تحتاج إلى:

• إنشاء مثيل إدارة Azure API

• فهم التخزين المؤقت في APIM

• امتلاك Azure Managed Redis أو ذاكرة تخزين مؤقت أخرى متوافقة مع Redis متاحة.

  هام

  تستخدم Azure API Management سلسلة الاتصال Redis للاتصال بذاكرة التخزين المؤقت. إذا كنت تستخدم Azure Managed Redis، فقم بتمكين مصادقة مفتاح الوصول في ذاكرة التخزين المؤقت لاستخدام سلسلة اتصال. حاليا، لا يمكنك استخدام مصادقة Microsoft Entra لتوصيل Azure API Management ب Azure Managed Redis.

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

بالنسبة إلى بوابة API Management المستضافة ذاتيا، يتطلب التخزين المؤقت ذاكرة تخزين مؤقت خارجية. لكي يكون التخزين المؤقت فعالًا، يجب أن تكون البوابة ذاتية الاستضافة وذاكرة التخزين المؤقت التي تعتمد عليها موجودة بالقرب من بعضها البعض لتقليل البحث وتخزين أوقات الاستجابة. يعد نشر ذاكرة التخزين المؤقت Redis في نفس مجموعة Kubernetes أو في مجموعة منفصلة قريبة أفضل الخيارات. تعرف على كيفية توزيع ذاكرة التخزين المؤقت Redis في مجموعة Kubernetes.

إضافة ذاكرة تخزين مؤقت خارجية

اتبع الخطوات أدناه لإضافة ذاكرة تخزين مؤقت خارجية متوافقة مع Redis لـ Redis في APIM. يمكنك تقييد ذاكرة التخزين المؤقت إلى بوابة معينة في مثيل APIM الخاص بك.

إعداد الاستخدام من

إعداد Use from في التكوين يحدد موقع مثيل APIM الذي سيستخدم ذاكرة التخزين المؤقت. حدد واحدًا مما يلي:

• منطقة Azure حيث تتم استضافة مثيل APIM (أو أحد المواقع المكونة، إذا كان لديك توزيع متعدد المناطق)

• موقع بوابة مستضافة ذاتيًّا

• افتراضي، لتكوين ذاكرة التخزين المؤقت كافتراضي لكافة مواقع البوابة في مثيل APIM

  يتم تجاوز ذاكرة التخزين المؤقت المستخدمة ل Default بواسطة ذاكرة تخزين مؤقت تستخدم لمنطقة أو موقع مطابق معين.

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

إشعار

يمكنك تكوين نفس ذاكرة التخزين المؤقت الخارجية لأكثر من مثيل APIM. يمكن أن تكون مثيلات APIM في نفس المناطق أو مناطق مختلفة. عند مشاركة ذاكرة التخزين المؤقت لأكثر من مثيل واحد، يجب تحديد Default في إعداد Use from.

إضافة مثيل Azure Managed Redis من نفس الاشتراك

1. استعرض للوصول إلى مثيل APIM الخاص بك في مدخل Microsoft Azure.
2. في القائمة اليمنى، ضمن Deployment + infrastructure حدد External cache.
3. حدد + إضافة.
4. في القائمة المنسدلة مثيل ذاكرة التخزين المؤقت، حدد ذاكرة التخزين المؤقت.
5. في القائمة المنسدلة استخدام من، حدد افتراضي أو حدد المنطقة المطلوبة. يتم ملء سلسلة الاتصال تلقائيا.
6. حدد حفظ.

إشعار

سلسلة الاتصال الافتراضية في النموذج <cache-name>:10000,password=<cache-access-key>,ssl=True,abortConnect=False. تخزن إدارة واجهة برمجة التطبيقات السلسلة كقيمة سرية مسماة. إذا كنت بحاجة إلى عرض السلسلة أو تحريرها لتدوير مفتاح الوصول أو استكشاف مشكلات الاتصال وإصلاحها، فانتقل إلى شفرة القيم المسماة .

إضافة ذاكرة تخزين مؤقت خارجية متوافقة مع Redis مستضافة خارج اشتراك Azure الحالي أو Azure بشكل عام

1. استعرض للوصول إلى مثيل APIM الخاص بك في مدخل Microsoft Azure.
2. في القائمة اليمنى، ضمن Deployment + infrastructure حدد External cache.
3. حدد + إضافة.
4. في القائمة المنسدلة Cache instance ، حدد Custom.
5. في القائمة المنسدلة استخدام من، حدد افتراضي أو حدد المنطقة المطلوبة.
6. أدخل سلسلة اتصال ذاكرة التخزين المؤقت المتوافقة مع Azure Managed Redis أو Redis في حقل سلسلة الاتصال .
7. حدد حفظ.

إضافة ذاكرة التخزين المؤقت Redis إلى بوابة مستضافة ذاتيًا

1. في القائمة اليمنى، ضمن Deployment + infrastructure حدد External cache.
2. حدد + إضافة.
3. في القائمة المنسدلة Cache instance ، حدد Custom.
4. في القائمة المنسدلة استخدام من، حدد افتراضي أو حدد المنطقة المطلوبة.
5. أدخل سلسلة الاتصال ذاكرة التخزين المؤقت Redis في حقل سلسلة الاتصال.
6. حدد حفظ.

استخدم ذاكرة التَخزين المؤقت الخارجية

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

للحصول على مثال مفصل، راجع إضافة التخزين المؤقت لتحسين الأداء في APIM.

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

• للحصول على مزيدٍ من المعلومات حول نُهج التخزين المؤقت، راجع نُهج التخزين المؤقت في مرجع نهج API Management.
• لتخزين العناصر مؤقتًا حسب المفتاح باستخدام تعبيرات النهج، راجع التخزين المؤقت المخصص في APIM.
• تعرف على كيفية تمكين التخزين المؤقت الدلالي لواجهات برمجة تطبيقات Azure OpenAI.