واجهات برمجة تطبيقات REST بلا خادم باستخدام وظائف Azure
Azure Functions هي خدمة حساب أساسية تستخدمها لإنشاء واجهات برمجة تطبيقات تستند إلى REST بلا خادم. تعرض مشغلات HTTP نقاط نهاية REST التي يمكن لعملائك استدعاؤها، مثل المتصفحات وتطبيقات الأجهزة المحمولة وخدمات الواجهة الخلفية الأخرى. مع الدعم الأصلي للمسارات، يمكن أن تعرض وظيفة HTTP واحدة مشغلة واجهة برمجة تطبيقات REST عالية الوظائف. كما توفر الوظائف نظام التخويل الأساسي الخاص بها للمساعدة في الحد من الوصول إلى عملاء محددين فقط. لمزيد من المعلومات، راجع مشغلات Azure Functions HTTP
في بعض السيناريوهات، قد تحتاج إلى واجهة برمجة التطبيقات لدعم مجموعة أكثر تعقيدًا من سلوكيات REST. على سبيل المثال، قد تحتاج إلى دمج نقاط نهاية دالة HTTP متعددة في واجهة برمجة تطبيقات واحدة. قد تحتاج أيضًا إلى تمرير الطلبات إلى خدمة خلفية واحدة أو أكثر تستند إلى REST. وأخيرًا، قد تتطلب واجهات برمجة التطبيقات الخاصة بك درجة أعلى من الأمان الذي يتيح لك تحقيق الدخل من استخدامه.
اليوم، النهج الموصى به لبناء واجهات برمجة تطبيقات أكثر تعقيدا وقوة استنادًا إلى وظائفك هو استخدام خدمات واجهة برمجة التطبيقات الشاملة التي توفرها Azure APIM. تستخدم APIM نموذجًا يستند إلى النهج للسماح لك بالتحكم في التوجيه والأمان وتكامل OpenAPI. كما أنه يدعم النهج المتقدمة مثل تحقيق الدخل من المعدل. استخدمت الإصدارات السابقة من وقت تشغيل الوظائف ميزة وكلاء الوظائف القديمة.
هام
وكلاء Azure Functions هي ميزة قديمة للإصدارات من 1.x إلى 3.x من وقت تشغيل Azure Functions. يمكن إعادة تمكين دعم الوكلاء في الإصدار 4.x لترقية تطبيقات الوظائف بنجاح إلى أحدث إصدار من وقت التشغيل. في أقرب وقت ممكن، يجب التبديل إلى دمج تطبيقات الوظائف الخاصة بك مع Azure API Management. تتيح لك APIM الاستفادة من مجموعة أكثر اكتمالا من الميزات لتحديد واجهات برمجة التطبيقات المستندة إلى الوظائف وتأمينها وإدارتها والاستفادة منها. لمزيد من المعلومات، راجع تكامل APIM.
لمعرفة كيفية إعادة تمكين دعم الوكلاء في Functions الإصدار 4.x، راجع إعادة تمكين الوكلاء في Functions v4.x.
الانتقال من Functions Proxies إلى APIM
عند الانتقال من Functions Proxies إلى استخدام APIM، يجب عليك دمج تطبيق الوظائف مع مثيل APIM، ثم تكوين مثيل APIM ليتصرف مثل الوكيل السابق. يوفر القسم التالي ارتباطات إلى المقالات ذات الصلة التي تساعدك على النجاح في استخدام APIM مع Azure Functions.
إذا كانت لديك تحديات في الانتقال من الوكلاء أو إذا لم تعالج Azure API Management سيناريوهاتك المحددة، فنشر طلبا في منتدى ملاحظات APIM.
دمج خدمة API Management
تتيح لك APIM استيراد تطبيق وظائف موجود. بعد الاستيراد، تصبح كل نقطة نهاية وظيفة تم تشغيلها بواسطة HTTP واجهة برمجة تطبيقات يمكنك تعديلها وإدارتها. بعد الاستيراد، يمكنك أيضًا استخدام APIM لإنشاء ملف تعريف OpenAPI لواجهات برمجة التطبيقات الخاصة بك. أثناء الاستيراد، يتم تجاهل أي نقاط نهاية بمستوى admin تخويل. لمزيد من المعلومات حول استخدام APIM مع Functions، راجع المقالات التالية:
| الفقرة | الوصف |
|---|---|
| كشف واجهات برمجة التطبيقات بلا خادم من نقاط نهاية HTTP باستخدام إدارة واجهة برمجة تطبيقات Azure | يوضح كيفية إنشاء مثيل APIM جديد من تطبيق دالة موجود في مدخل Microsoft Azure. يدعم جميع اللغات. |
| إنشاء واجهات برمجة تطبيقات بلا خادم في Visual Studio باستخدام تكامل Azure Functions وAPIM | يوضح كيفية استخدام Visual Studio لإنشاء مشروع C# يستخدم ملحق OpenAPI. يتيح لك ملحق OpenAPI تحديد واجهات برمجة تطبيقات .NET الخاصة بك عن طريق تطبيق السمات مباشرة على تعليمات C# البرمجية الخاصة بك. |
| التشغيل السريع: إنشاء مثيل خدمة Azure API Management جديد باستخدام مدخل Microsoft Azure | إنشاء مثيل APIM جديد في المدخل. بعد إنشاء مثيل APIM، يمكنك توصيله بتطبيق الوظائف الخاص بك. يتم دعم أساليب إنشاء أخرى غير المدخل. |
| استيراد تطبيق وظائف Azure كواجهة برمجة تطبيقات في Azure APIM | يوضح كيفية استيراد تطبيق دالة موجود لعرض نقاط نهاية مشغل HTTP الحالية كواجهة برمجة تطبيقات مدارة. تدعم هذه المقالة إنشاء واجهة برمجة تطبيقات جديدة وإضافة نقاط النهاية إلى واجهة برمجة تطبيقات مدارة موجودة. |
بعد أن يتم عرض نقاط نهاية تطبيق الوظائف باستخدام APIM، توفر المقالات التالية معلومات عامة حول كيفية إدارة واجهات برمجة التطبيقات المستندة إلى الوظائف في مثيل APIM.
| الفقرة | الوصف |
|---|---|
| تحرير واجهة برمجة تطبيقات | يوضح لك كيفية العمل مع واجهة برمجة تطبيقات موجودة مستضافة في APIM. |
| النُهج في Azure API Management | في APIM، يمكن للناشرين تغيير سلوك واجهة برمجة التطبيقات من خلال التكوين باستخدام النُهج. النُهج هي مجموعة من العبارات التي يتم تشغيلها بشكل تسلسلي بناءً على طلب أو استجابة واجهة برمجة التطبيقات. |
| مرجع نهج إدارة واجهة برمجة التطبيقات | الرجوع إلى تفاصيل جميع نهج APIM المدعومة. |
| نماذج نهج إدارة واجهة برمجة التطبيقات | مجموعة مفيدة من العينات باستخدام نهج APIM في السيناريوهات الرئيسية. |
Functions Proxies القديم
توفر ميزة Functions Proxies القديمة أيضًا مجموعة من وظائف واجهة برمجة التطبيقات الأساسية للإصدار 3.x والإصدار الأقدم من وقت تشغيل الوظائف.
هام
وكلاء Azure Functions هي ميزة قديمة للإصدارات من 1.x إلى 3.x من وقت تشغيل Azure Functions. يمكن إعادة تمكين دعم الوكلاء في الإصدار 4.x لترقية تطبيقات الوظائف بنجاح إلى أحدث إصدار من وقت التشغيل. في أقرب وقت ممكن، يجب التبديل إلى دمج تطبيقات الوظائف الخاصة بك مع Azure API Management. تتيح لك APIM الاستفادة من مجموعة أكثر اكتمالا من الميزات لتحديد واجهات برمجة التطبيقات المستندة إلى الوظائف وتأمينها وإدارتها والاستفادة منها. لمزيد من المعلومات، راجع تكامل APIM.
لمعرفة كيفية إعادة تمكين دعم الوكلاء في Functions الإصدار 4.x، راجع إعادة تمكين الوكلاء في Functions v4.x.
تمت إضافة بعض التلميحات الأساسية لكيفية تنفيذ المهام المكافئة باستخدام APIM إلى مقالة Functions Proxies. ليس لدينا حاليًا وثائق أو أدوات لمساعدتك في ترحيل تنفيذ وكلاء الوظائف الموجودة إلى APIM.