اقرأ باللغة الإنجليزية

مشاركة عبر


استيراد تطبيق دالة Azure كواجهة برمجة تطبيقات في Azure API Management

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

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

ملاحظة

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

توضح هذه المقالة كيفية استيراد تطبيق دالة Azure كواجهة برمجة تطبيقات إلى Azure API Management واختبار واجهة برمجة التطبيقات.

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

  • استيراد تطبيق دالة Azure كواجهة برمجة تطبيقات
  • إلحاق تطبيق دالة Azure بواجهة برمجة تطبيقات
  • عرض مفتاح مضيف تطبيق الوظائف الجديد وإدارة واجهة برمجة التطبيقات المسماة value
  • حدد التطبيق في مدخل Microsoft Azure

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

  • أكمل التشغيل السريعلمثيل Azure APIM.
  • تأكد من أن لديك تطبيق وظائف Azure في اشتراكك. لمزيد مـن المعلومات، راجع بدء استخدام دالة Azure. يجب أن تحتوي الدالة على مشغل HTTP. يجب تعيين مستوى التخويل إلى مجهول أو دالة.

ملاحظة

يمكنك أيضا استخدام ملحق إدارة واجهة برمجة التطبيقات ل Visual Studio Code لاستيراد واجهات برمجة التطبيقات وإدارتها. أكمل البرنامج التعليمي لملحق إدارة واجهة برمجة التطبيقات للبدء.

استيراد تطبيق دالة Azure كواجهة برمجة تطبيقات جديدة

لإنشاء واجهة برمجة تطبيقات جديدة من تطبيق وظائف Azure:

  1. انتقل إلى خدمة API Management في مدخل Microsoft Azure.

  2. حددواجهات برمجة التطبيقات APIs> في الجزء الأيمن.

  3. ضمن Create from Azure resource، حدد Function App:

    لقطة شاشة تعرض لوحة Function App في مدخل Microsoft Azure.

  4. حدد الزر استعراض :

    لقطة شاشة تبرز الزر استعراض.

  5. انقر فوق الزر Select ضمن Configure required settings للاختيار من قائمة تطبيقات الوظائف المتوفرة:

    لقطة شاشة تعرض الزر تحديد.

  6. ابحث عن تطبيق الوظائف الذي تريد استيراد الوظائف منه، وحدده، ثم انقر فوق تحديد:

    لقطة شاشة تعرض تطبيق دالة وزر تحديد.

  7. حدد الدالات التي تريد استيرادها وانقر فوق تحديد. يمكنك فقط استيراد الدالات التي تحتوي على مشغل HTTP ومستوى تخويل مجهول أو دالة .

    لقطة شاشة تعرض دالة وزر تحديد.

  8. قم بالتبديل إلى طريقة العرض الكاملة وقم بتعيين منتج إلى واجهة برمجة التطبيقات الجديدة.

    ملاحظة

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

    في بعض مستويات التسعير، تأتي مثيلات APIM مع اثنين من نماذج المنتجات الافتراضية:

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

  10. حدد إنشاء.

إلحاق تطبيق دالة بواجهة برمجة تطبيقات موجودة

لإلحاق تطبيق دالة بواجهة برمجة تطبيقات موجودة:

  1. في مثيل خدمة Azure API Management، حددواجهات برمجة التطبيقات APIs> في الجزء الأيمن.

  2. اختر واجهة برمجة تطبيقات تريد استيراد تطبيق دالة إليها. حدد علامة الحذف (...) بجوار واجهة برمجة التطبيقات، ثم حدد استيراد:

    لقطة شاشة تعرض خيار قائمة الاستيراد.

  3. حدد لوحة Function App :

    لقطة شاشة تعرض لوحة Function App.

  4. في نافذة Import from Function App، حدد Browse:

    #B0 #A1 #A2 #A3 لقطة شاشة تعرض الزر استعراض. #A4 #A5 #A6 #C7

  5. انقر فوق الزر Select ضمن Configure required settings للاختيار من قائمة تطبيقات الوظائف المتوفرة:

    لقطة شاشة تعرض قسم Function App.

  6. ابحث عن تطبيق الوظائف الذي تريد استيراد الوظائف منه، وحدده، ثم انقر فوق تحديد:

    لقطة شاشة تعرض تطبيق الوظائف والزر Select.

  7. حدد الدالات التي تريد استيرادها، ثم انقر فوق تحديد:

    لقطة شاشة تعرض قائمة الوظائف.

  8. حدد استيراد:

    لقطة شاشة تعرض زر الاستيراد.

التصريح

عند استيراد تطبيق وظائف Azure، يتم إنشاء هذه العناصر تلقائيا:

  • مفتاح مضيف في تطبيق الوظائف. يسمى apim-<your API Management service instance name>المفتاح .
  • قيمة مسماة في مثيل APIM الذي يحتوي على الاسم <your Azure function app instance name>-key. تحتوي هذه القيمة على مفتاح المضيف.

بالنسبة لواجهات برمجة التطبيقات التي تم إنشاؤها بعد 4 أبريل 2019، يتم تمرير مفتاح المضيف في طلبات HTTP من APIM إلى تطبيق الوظائف في رأس الصفحة. تقوم واجهات برمجة التطبيقات القديمة بتمرير مفتاح المضيف باعتباره معلمة استعلام. يمكنك تغيير هذا السلوك باستخدام PATCH Backendاستدعاء REST API على Backend الكيان المقترن بتطبيق الوظائف.

تحذير

ستؤدي إزالة أو تغيير قيمة مفتاح مضيف تطبيق دالة Azure أو قيمة API Management المسماة إلى تعطيل الاتصال بين الخدمات. لا تتم مزامنة القيم تلقائيا.

إذا كنت بحاجة إلى تدوير مفتاح المضيف، فتأكد أيضا من تغيير القيمة المسماة في APIM.

الوصول إلى مفتاح مضيف تطبيق الوظائف

  1. انتقل إلى مثيل تطبيق دالة Azure:

    لقطة شاشة تعرض قائمة بمثيلات تطبيق الوظائف.

  2. في قسم Functions في الجزء الأيمن، حدد App keys:

    لقطة شاشة تعرض مفاتيح التطبيقات في القائمة.

  3. ابحث عن المفاتيح في قسم مفاتيح المضيف :

    لقطة شاشة تعرض مفاتيح المضيف.

الوصول إلى القيمة المسماة في APIM

انتقل إلى مثيل APIM وحدد APIs>Named values في الجزء الأيمن. يتم تخزين مفتاح تطبيق وظيفة Azure هناك.

لقطة شاشة تعرض موقع مفتاح تطبيق الوظائف.

اختبار API الجديد في مدخل Microsoft Azure

يمكنك استدعاء العمليات مباشرة من مدخل Azure. يعد استخدام مدخل Azure طريقة مناسبة لعرض عمليات واجهة برمجة التطبيقات واختبارها.

#B0 #A1 #A2 #A3 لقطة شاشة تعرض خطوات اختبار واجهة برمجة التطبيقات. #A4 #A5 #A6 #C7

  1. حدد واجهة برمجة التطبيقات التي قمت بإنشائها في القسم السابق.

  2. حدد علامة التبويب الاختبار.

  3. حدد العملية التي تريد اختبارها.

    • تعرض الصفحة حقولاً لمعلمات وعناوين الاستعلام.
    • أحد العناوين هو Ocp-Apim-Subscription-Key. هذا العنوان مخصص لمفتاح اشتراك المنتج المقترن بواجهة برمجة التطبيقات.
    • إذا قمت بإنشاء مثيل APIM، فأنت مسؤول، لذلك يتم ملء المفتاح تلقائيا.
  4. حدد إرسال.

    عند نجاح الاختبار، تستجيب الخلفية ب 200 موافق وبعض البيانات.