تصحيح أخطاء نهج Azure API Management في تعليمات Visual Studio البرمجية
ينطبق على: المطور
توفر Policies في Azure API Management قدرات قوية تساعد ناشري API على معالجة المخاوف الشاملة مثل المصادقة والتخويل والخنق والتخزين المؤقت والتحول. المعايير هي مجموعة من العبارات التي يتم تنفيذها بالتسلسل بناءً على طلب أو استجابة واجهة برمجة التطبيقات.
توضح هذه المقالة كيفية تصحيح أخطاء نهج API Management باستخدام ملحق إدارة API Azure لتعليمات Visual Studio البرمجية.
المتطلبات الأساسية
إنشاء مثيل طبقة المطور API Management باتباع هذا التشغيل السريع أولًا.
قم بتثبيت Visual Studio Code وأحدث إصدار من ملحق إدارة API Azure لتشغيل Visual Studio Code.
قم باستيراد API إلى مثيل إدارة واجهة برمجة التطبيقات. لخطوات بالمثال، راجع البرنامج التعليمي: استخدام ملحق إدارة API الخاصة بـ Visual Studio Code لاستيراد واجهات برمجة التطبيقات وإدارتها.
القيود والمحددات
- تستخدم هذه الميزة اشتراك الوصول بالكامل المضمن (على مستوى الخدمة) (اسم العرض "اشتراك الوصول بالكامل المضمن") لتصحيح الأخطاء.
هام
- لم تعد API Management تدعم الاشتراكات للتتبع أو رأس Ocp-Apim-Trace .
- لتحسين أمان واجهة برمجة التطبيقات، يمكن الآن تمكين التتبع على مستوى واجهة برمجة تطبيقات فردية عن طريق الحصول على رمز مميز محدود زمنيا باستخدام API Management REST API، وتمرير الرمز المميز في طلب إلى البوابة. للحصول على التفاصيل، راجع تمكين تتبع واجهة برمجة التطبيقات.
- احرص عند تمكين التتبع، لأنه يمكن أن يعرض معلومات حساسة في بيانات التتبع. تأكد من وجود تدابير أمان مناسبة لحماية بيانات التتبع.
بدء جلسة عمل تصحيح الأخطاء
- تشغيل تعليمات Visual Studio البرمجية
- الانتقال إلى ملحق API Management ضمن ملحقات Azure
- البحث عن مثيل API Management لتصحيح الأخطاء
- البحث عن API والعملية لتصحيح الأخطاء
- انقر بزر الماوس الأيمن على العملية وحدد Start policy debugging
عند هذه النقطة، سيحاول الملحق بدء تأسيس جلسة عمل تصحيح الأخطاء باستخدام بوابة API Management.
إرسال طلب اختبار
عند تأسيس جلسة عمل تصحيح الأخطاء، سيتم فتح ملحق محرر جديد يسمح لنا بإنشاء طلب HTTP للاختبار وإرساله إلى هذه العملية للاستفادة من ملحق عميل REST.
ستلاحظ عنوان Ocp-Apim-Debug قد تمت إضافته بالفعل إلى الطلب. هذا العنوان مطلوب ويجب تعيين القيمة إلى مفتاح الاشتراك على مستوى الخدمة، كافة الوصول لتشغيل وظيفة تصحيح الأخطاء في بوابة API Management.
تعديل طلب HTTP في المحرر وفقًا لسيناريو الاختبار الخاص بك. ثم انقر فوق send request لإرسال طلب الاختبار إلى بوابة API Management.
تصحيح النهج
بعد إرسال طلب HTTP للاختبار، سيتم فتح ملحق إطار تصحيح الأخطاء ليعرض النهج الفعالة لهذه العملية ويتوقف عند النهج الفعال الأول.
لاتباع نهج البنية الأساسية لبرنامج ربط العمليات التجارية، يمكنك التقدم مرة واحدة من خلال نهج فردية أو تعيين نقطة توقف في نهج والتقدم مباشرة إلى هذا النهج.
في لوحة Variables، يمكنك فحص قيم المتغيرات التي أنشأها النظام والمنشأة من قبل المستخدم. في لوحة Breakpoints، يمكنك مشاهدة قائمة كافة نقاط التوقف التي تم تعيينها. في لوحة Call Stack، يمكنك مشاهدة نطاق النهج الفعال الحالي.
إذا كان هناك خطأ أثناء تنفيذ النهج، سترى تفاصيل الخطأ في النهج حيث حدث.
تلميح
تذكر لإنهاء جلسة عمل تصحيح الأخطاء، بالنقر فوق زر Stop عند الانتهاء.
الخطوات التالية
- تعرف على المزيد حول ملحق API Management لتعليمات Visual Studio البرمجية.
- الإبلاغ عن مشكلات في مستودع GitHub