مشاركة عبر

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

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

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

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

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

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

إشعار

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

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

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

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

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

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

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

  2. ضمن واجهات برمجة التطبيقات في قائمة الشريط الجانبي، اختر واجهات برمجة التطبيقات.

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

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

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

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

    1. أدخل اسم عرض.

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

    3. بالنسبة إلى عنوان URL لخادم gRPC، أدخل عنوان خدمة gRPC. يجب أن يكون العنوان متاحا عبر HTTPS.

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

      هام

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

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

  7. حدد إنشاء.

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

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

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

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

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

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

إشعار

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

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

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

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

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

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

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

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

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

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

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

  • Last updated on