Share via

استيراد واجهة برمجة تطبيقات gRPC (معاينة)

  • مقالة

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

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

لإضافة واجهة برمجة تطبيقات gRPC إلى APIM، تحتاج إلى:

  • تحميل ملف تعريف Protobuf (المخزن المؤقت للبروتوكول) إلى API Management
  • تحديد موقع خدمة gRPC
  • تكوين واجهة برمجة التطبيقات في APIM

تدعم APIM التمرير مع الأنواع التالية من أساليب خدمة gRPC: أحادي، وتدفق الخادم، وتدفق العميل، والتدفق ثنائي الاتجاه. للحصول على خلفية حول gRPC، راجع مقدمة إلى gRPC.

إشعار

  • استيراد واجهة برمجة تطبيقات gRPC قيد المعاينة. حاليا، يتم دعم واجهات برمجة تطبيقات gRPC فقط في البوابة المستضافة ذاتيا، وليس البوابة المدارة لمثيل APIM الخاص بك.
  • حاليا، اختبار واجهات برمجة تطبيقات gRPC غير مدعوم في وحدة تحكم الاختبار في مدخل Microsoft Azure أو في مدخل مطور APIM.

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

  • مثيل API Management. إذا لم يكن لديك واحد بالفعل، فأكمل التشغيل السريع التالي: إنشاء مثيل إدارة واجهة برمجة تطبيقات Azure.

  • مورد بوابة تم توفيره في المثيل الخاص بك. إذا لم يكن لديك بوابة بالفعل، فشاهد توفير بوابة مستضافة ذاتيا في Azure API Management.

  • ملف gRPC Protobuff (.proto) متوفر محليا وخدمة gRPC التي يمكن الوصول إليها عبر HTTPS.

إضافة واجهة برمجة تطبيقات gRPC

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.

  2. في القائمة اليسرى، حدد APIs>+ Add API.

  3. ضمن تعريف واجهة برمجة تطبيقات جديدة، حدد gRPC.

    لقطة شاشة لإنشاء واجهة برمجة تطبيقات gRPC في المدخل.

  4. في نافذة Create a gRPC API، حدد Full.

  5. بالنسبة لواجهة برمجة تطبيقات gRPC، يجب تحديد الإعدادات التالية:

    1. في Upload schema، حدد ملف .proto محليا مقترنا بواجهة برمجة التطبيقات لاستيراده.

    2. في عنوان URL لخادم gRPC، أدخل عنوان خدمة gRPC. يجب أن يكون العنوان متاحا عبر HTTPS.

    3. في Gateways، حدد مورد البوابة الذي تريد استخدامه لعرض واجهة برمجة التطبيقات.

      هام

      في المعاينة العامة، يمكنك فقط تحديد بوابة ذاتية الاستضافة. البوابة المدارة غير مدعومة.

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

  7. حدد إنشاء.

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

إلحاق واجهات برمجة تطبيقات أخرى

يمكنك إنشاء واجهة برمجة تطبيقات من واجهات برمجة التطبيقات التي تعرضها الخدمات المختلفة، وتشمل:

  • مواصفات OpenAPI
  • واجهة برمجة تطبيقات SOAP
  • واجهة برمجة تطبيقات GraphQL
  • Web App مستضاف في Azure App Service
  • تطبيق الوظائف Azure
  • Azure Logic Apps
  • Azure Service Fabric

إلحاق واجهة برمجة تطبيقات أخرى بتلك الحالية باتباع الخطوات التالية.

إشعار

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

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

    الانتقال إلى مثيل Azure API Mgmt

  2. حدّد واجهات برمجة التطبيقات في الصفحة نظرة عامة أو من القائمة الموجودة إلى اليمين.

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

  3. انقر فوق ... بجوار واجهة برمجة التطبيقات التي تريد إلحاق واجهة برمجة تطبيقات أخرى بها.

  4. حدّد استيراد من القائمة المنسدلة.

    حدد استيراد

  5. حدّد خدمة لاستيراد واجهة برمجة تطبيقات منها.

    تحديد خدمة