مشاركة عبر

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

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

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

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

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

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

إشعار

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

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

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

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

  • دعم بروتوكول HTTP/2 مفعل لحركة مرور العملاء. لمزيد من المعلومات، راجع إدارة البروتوكولات والشفرات في Azure API Management.

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

  1. في مدخل Microsoft Azure، انتقل إلى مثيل APIM.

  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