مشاركة عبر

استيراد واجهة برمجة تطبيقات gRPC

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

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

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

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

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

إشعار

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

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

  • مثيل 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. حدد إنشاء.

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

استدعاء خدمات gRPC باستخدام .NET

للحصول على معلومات حول استدعاء خدمات gRPC باستخدام .NET، راجع المقالات التالية:

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

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

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

إشعار

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

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

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

    لقطة شاشة تعرض صفحة خدمات APIM.

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

    لقطة شاشة تعرض تحديد واجهات برمجة التطبيقات في صفحة نظرة عامة.

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

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

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

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

المحتويات ذات الصلة