مشاركة عبر


كشف واجهات برمجة التطبيقات بلا خادم من نقاط نهاية HTTP باستخدام إدارة واجهة برمجة تطبيقات Azure

تتكامل Azure Functions مع Azure API Management في المدخل للسماح لك بعرض نقاط نهاية دالة مشغل HTTP كواجهات برمجة تطبيقات REST. يتم وصف واجهات برمجة التطبيقات هذه باستخدام تعريف OpenAPI. يحتوي ملف JSON (أو YAML) هذا على معلومات حول العمليات المتوفرة في واجهة برمجة التطبيقات. ويتضمن تفاصيل حول كيفية هيكلة بيانات الطلب والاستجابة لواجهة برمجة التطبيقات. من خلال دمج تطبيق الوظائف الخاص بك، يمكن أن يكون لديك API Management تنشئ تعريفات OpenAPI هذه.

توضح لك هذه المقالة كيفية دمج تطبيق الوظائف مع APIM. يعمل هذا التكامل مع تطبيقات الوظائف التي تم تطويرها بأي لغة مدعومة. يمكنك أيضا استيراد تطبيق الوظائف من Azure API Management.

بالنسبة إلى وظائف مكتبة فئة C#، يمكنك أيضا استخدام Visual Studio لإنشاء ونشر واجهة برمجة تطبيقات بلا خادم تتكامل مع APIM.

إنشاء مثيل APIM

لإنشاء مثيل APIM مرتبط بتطبيق الوظائف:

  1. حدد تطبيق الوظائف، واختر API Management من القائمة اليسرى، ثم حدد Create new ضمن API Management.

  2. استخدم إعدادات API Management كما هو محدد في الجدول التالي:

    الإعدادات القيمة المقترحة ‏‏الوصف
    الاشتراك اشتراكك الاشتراك الذي يتم إنشاء هذا المورد الجديد بموجبه.
    مجموعة الموارد myResourceGroup نفس المورد مثل تطبيق الوظائف الخاص بك، والذي يجب تعيينه لك.
    قطر موقع الخدمة ضع في اعتبارك اختيار نفس موقع تطبيق الوظائف.
    اسم المورد اسم فريد عالميًا يتم إنشاء اسم استنادا إلى اسم تطبيق الوظائف.
    اسم المؤسسة كونتوسو اسم المؤسسة المستخدمة في مدخل المطور وإشعارات البريد الإلكتروني.
    البريد الإلكتروني للمسؤول بريدك الإلكتروني البريد الإلكتروني الذي تلقى إعلامات النظام من APIM.
    مستوى الأسعار الاستهلاك‬ مستوى الاستهلاك غير متوفر في جميع المناطق. للحصول على تفاصيل التسعير الكاملة، راجع صفحة تسعير APIM
  3. اختر Review + create ثم Create لإنشاء مثيل APIM، والذي قد يستغرق عدة دقائق.

استيراد الدالات

بعد إنشاء مثيل APIM، يمكنك استيراد نقاط نهاية الدالة التي تم تشغيلها بواسطة HTTP. يستورد هذا المثال نقطة نهاية تسمى TurbineRepair.

  1. في صفحة API Management، حدد Link API.

  2. يتم فتح Import Azure Functions مع تمييز وظيفة TurbineRepair . اختر تحديد للمتابعة.

  3. في صفحة Create from Function App ، اقبل الإعدادات الافتراضية، ثم حدد Create. ينشئ Azure واجهة برمجة التطبيقات للوظيفة.

تنزيل تعريف OpenAPI

بعد استيراد الوظائف الخاصة بك، يمكنك تنزيل تعريف OpenAPI من مثيل APIM.

  1. حدد تنزيل تعريف OpenAPI في أعلى الصفحة.

    تنزيل تعريف OpenAPI

  2. احفظ ملف JSON الذي تم تنزيله، ثم افتحه. راجع التعريف.

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

يمكنك الآن تحسين التعريف في APIM في المدخل. يمكنك أيضا معرفة المزيد حول APIM.