مشاركة عبر

تصحيح أخطاء نهج Azure API Management في تعليمات Visual Studio البرمجية

  • مقالة

ينطبق على: المطور

توفر Policies في Azure API Management قدرات قوية تساعد ناشري API على معالجة المخاوف الشاملة مثل المصادقة والتخويل والخنق والتخزين المؤقت والتحول. المعايير هي مجموعة من العبارات التي يتم تنفيذها بالتسلسل بناءً على طلب أو استجابة واجهة برمجة التطبيقات.

توضح هذه المقالة كيفية تصحيح أخطاء نهج API Management باستخدام ملحق إدارة API Azure لتعليمات Visual Studio البرمجية.

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

القيود والمحددات

  • تستخدم هذه الميزة اشتراك الوصول بالكامل المضمن (على مستوى الخدمة) (اسم العرض "اشتراك الوصول بالكامل المضمن") لتصحيح الأخطاء.

هام

  • يتم إهمال تتبع طلب إدارة واجهة برمجة التطبيقات باستخدام عنوان Ocp-Apim-Trace في طلب واستخدام قيمة عنوان استجابة Ocp-Apim-Trace-Location .
  • لتحسين الأمان، يمكن الآن تمكين التتبع على مستوى واجهة برمجة تطبيقات فردية عن طريق الحصول على رمز مميز محدود زمنيا باستخدام API Management REST API، وتمرير الرمز المميز في طلب إلى البوابة. للحصول على التفاصيل، راجع تمكين تتبع واجهة برمجة التطبيقات.
  • احرص عند تمكين التتبع، لأنه يمكن أن يعرض معلومات حساسة في بيانات التتبع. تأكد من وجود تدابير أمان مناسبة لحماية بيانات التتبع.

بدء جلسة عمل تصحيح الأخطاء

  1. تشغيل تعليمات Visual Studio البرمجية
  2. الانتقال إلى ملحق API Management ضمن ملحقات Azure
  3. البحث عن مثيل API Management لتصحيح الأخطاء
  4. البحث عن API والعملية لتصحيح الأخطاء
  5. انقر بزر الماوس الأيمن على العملية وحدد Start policy debugging

عند هذه النقطة، سيحاول الملحق بدء تأسيس جلسة عمل تصحيح الأخطاء باستخدام بوابة API Management.

بدء تصحيح الأخطاء

إرسال طلب اختبار

عند تأسيس جلسة عمل تصحيح الأخطاء، سيتم فتح ملحق محرر جديد يسمح لنا بإنشاء طلب HTTP للاختبار وإرساله إلى هذه العملية للاستفادة من ملحق عميل REST.

ستلاحظ عنوان Ocp-Apim-Debug قد تمت إضافته بالفعل إلى الطلب. هذا العنوان مطلوب ويجب تعيين القيمة إلى مفتاح الاشتراك على مستوى الخدمة، كافة الوصول لتشغيل وظيفة تصحيح الأخطاء في بوابة API Management.

تعديل طلب HTTP في المحرر وفقًا لسيناريو الاختبار الخاص بك. ثم انقر فوق send request لإرسال طلب الاختبار إلى بوابة API Management.

إرسال طلب اختبار

تصحيح النهج

بعد إرسال طلب HTTP للاختبار، سيتم فتح ملحق إطار تصحيح الأخطاء ليعرض النهج الفعالة لهذه العملية ويتوقف عند النهج الفعال الأول.

تصحيح أخطاء النهج

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

في لوحة Variables، يمكنك فحص قيم المتغيرات التي أنشأها النظام والمنشأة من قبل المستخدم. في لوحة Breakpoints، يمكنك مشاهدة قائمة كافة نقاط التوقف التي تم تعيينها. في لوحة Call Stack، يمكنك مشاهدة نطاق النهج الفعال الحالي.

إذا كان هناك خطأ أثناء تنفيذ النهج، سترى تفاصيل الخطأ في النهج حيث حدث.

الاستثناءات

تلميح

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

الخطوات التالية