إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات
تصف هذه المقالة الأدوار والميزات لمكون بوابة إدارة واجهة برمجة التطبيقات. كما يقارن بين البوابات التي يمكنك نشرها.
معلومات ذات صلة:
للحصول على نظرة عامة حول سيناريوهات APIM ومكوناتها ومفاهيمها، راجع ما هي إدارة واجهة برمجة تطبيقات Azure؟
لمزيد من المعلومات حول مستويات وميزات خدمة APIM، راجع:
- مستويات إدارة واجهة برمجة التطبيقات
- مقارنة تستند إلى الميزات لمستويات إدارة واجهة برمجة تطبيقات Azure.
دور البوابة
بوابة APIM (تسمى أيضاً مستوى البيانات أو وقت التشغيل) هي مكون الخدمة المسؤول عن تهيئة وكيل لطلبات واجهة برمجة التطبيقات وتطبيق النهج وجمع بيانات تتبع الاستخدام.
على وجه التحديد، البوابة:
- تعمل كواجهة للخدمات الخلفية من خلال قبول استدعاءات API وتوجيهها إلى الخلفيات المناسبة
- التحقق من مفاتيح واجهة برمجة التطبيقات وبيانات الاعتماد الأخرى مثل JWTs والشهادات المقدمة مع الطلبات
- فرض حصص الاستخدام وحدود المعدل
- اختياريًا يحول الطلبات والاستجابات كما هو محدد في بيانات السياسة
- إذا تم تكوينها، تقوم بتخزين الاستجابات مؤقتاً لتحسين زمن انتقال الاستجابة وتقليل الحمل على خدمات الواجهة الخلفية
- تصدر سجلات ومقاييس وتتبعات من أجل المراقبة وإعداد التقارير واستكشاف الأخطاء وإصلاحها
Note
جميع الطلبات إلى بوابة إدارة API، بما في ذلك تلك المرفوضة من قبل تكوينات السياسات، تحتسب ضمن حدود السعر المكونة، والحصص، وحدود الفوترة إذا طبقتها طبقة الخدمة.
البوابات المدارة والمستضافة ذاتيا
توفر APIM كلاً من البوابات المدارة والمستضافة ذاتياً:
الإدارة - البوابة المدارة هي المكون الافتراضي الذي يقوم Azure بنشره لكل مثيل إدارة واجهة برمجة تطبيقات في كل مستوى خدمة. يمكنك أيضا ربط بوابة مدارة مستقلة بمساحة عمل في مثيل إدارة واجهة برمجة التطبيقات في مستويات خدمة محددة. باستخدام البوابة المدارة، تتدفق جميع حركة مرور واجهات برمجة التطبيقات عبر Azure بغض النظر عن مكان استضافة الخلفيات التي تنفذ واجهات برمجة التطبيقات (APIs).
Note
نظرا للاختلافات في بنية الخدمة الأساسية، فإن البوابات المقدمة في مستويات خدمة APIM المختلفة لها بعض الاختلافات في القدرات. للحصول على التفاصيل، راجع القسم مقارنة الميزات: البوابات المدارة مقابل البوابات المستضافة ذاتياً.
الاستضافة الذاتية - البوابة المستضافة ذاتيا هي نسخة اختيارية محوية من البوابة المدارة الافتراضية المتاحة في مستويات خدمة محددة. إنه مفيد للسيناريوهات المختلطة ومتعددة السحابات حيث هناك شرط لتشغيل البوابات خارج Azure في نفس البيئات حيث تتم استضافة واجهات برمجة التطبيقات الخلفية. تمكن البوابة المستضافة ذاتياً العملاء الذين لديهم بنية أساسية مختلطة لتكنولوجيا المعلومات من إدارة واجهات برمجة التطبيقات المستضافة محلياً وعبر السحب من خدمة APIM واحدة في Azure.
يتم حزم البوابة المستضافة ذاتياً كحاوية Docker مستندة إلى Linux ويتم نشرها عادة في Kubernetes، بما في ذلك خدمة Azure Kubernetes و Kubernetes التي تدعم Azure Arc.
ترتبط كل بوابة مستضافة ذاتياً بمورد البوابة في مثيل APIM المستند إلى السحابة الذي تتلقى منه تحديثات التكوين وتتصل بالحالة.
مقارنة الميزات: البوابات المدارة مقابل البوابات المستضافة ذاتياً
تقارن الجداول التالية الميزات المتوفرة في بوابات APIM التالية:
- كلاسيكي - البوابة المدارة المتوفرة في مستويات الخدمة المطور والأساسي والقياسي والمتميزة (التي تم تجميعها سابقا كمستويات مخصصة )
- V2 - البوابة المدارة المتوفرة في المستويات Basic v2 وStandard v2 وPremium v2
- Consumption - البوابة المدارة المتوفرة في مستوى الاستهلاك
- الاستضافة الذاتية - البوابة الاختيارية المستضافة ذاتيا المتوفرة في مستويات خدمة محددة
- مساحة العمل - البوابة المدارة المتوفرة في مساحة عمل في مستويات خدمة محددة
Note
- يتم دعم بعض ميزات البوابات المدارة والمستضافة ذاتياً فقط في مستويات خدمة معينة أو مع بيئات توزيع معينة للبوابات المستضافة ذاتياً.
- لرؤية الميزات المدعومة حاليا للبوابة المستضافة ذاتيا، تأكد من ترقيتك إلى أحدث إصدار رئيسي من صورة حاوية البوابة المستضافة ذاتيا.
- راجع أيضاً قيود البوابة المستضافة ذاتياً.
Infrastructure
| دعم الميزات | Classic | V2 | Consumption | Self-hosted | Workspace |
|---|---|---|---|---|---|
| المجالات المخصصة | ✔️ | ✔️ | ✔️ | ✔️ | ❌ |
| ذاكرة التخزين المؤقت المضمنة | ✔️ | ✔️ | ❌ | ❌ | ✔️ |
| ذاكرة التخزين المؤقت الخارجية المتوافقة مع Redis | ✔️ | ✔️ | ✔️ | ✔️ | ❌ |
| حقن الشبكة الظاهرية | مطور ، بريميوم | الإصدار المميز v2 | ❌ | ✔️1,2 | ✔️ |
| نقاط النهاية الخاصة الواردة | ✔️ | الإصدار 2 القياسي، Premium v2 | ❌ | ❌ | ❌ |
| تكامل الشبكة الظاهرية الصادرة | ❌ | الإصدار 2 القياسي، Premium v2 | ❌ | ❌ | ✔️ |
| مناطق التوفر | Premium | الإصدار المميز v2 | ❌ | ✔️1 | ❌ |
| النشر متعدد المناطق | Premium | ❌ | ❌ | ✔️1 | ❌ |
| شهادات جذر CA للتحقق من صحة الشهادة | ✔️ | ✔️6 | ❌ | ✔️3 | ❌ |
| شهادات المجال المدارة | ✔️ | ❌ | ✔️ | ❌ | ❌ |
| إعدادات طبقة النقل الآمنة | ✔️ | ✔️ | ✔️ | ✔️ | ❌ |
| HTTP / 2 (العميل إلى البوابة) | ✔️4 | ✔️4 | ❌ | ✔️ | ❌ |
| HTTP / 2 (البوابة إلى الخلفية) | ✔️7 | ❌ | ❌ | ✔️5 | ❌ |
| الكشف عن تهديدات واجهة برمجة التطبيقات باستخدام Defender لواجهات برمجة التطبيقات | ✔️ | ✔️ | ❌ | ❌ | ❌ |
1 يعتمد على كيفية نشر البوابة، ولكن هي مسؤولية العميل.
2 يتطلب الاتصال بنقطة نهاية تكوين البوابة المستضافة ذاتيا v2 دقة DNS لاسم مضيف نقطة النهاية.
تتم إدارة 3 شهادات جذر CA للبوابة المستضافة ذاتيا بشكل منفصل لكل بوابة.
4 يجب تمكين بروتوكول العميل.
5 قم بالتكوين باستخدام نهج طلب إعادة التوجيه .
6 تكوين تفاصيل شهادة CA لمصادقة شهادة الواجهة الخلفية في إعدادات الخلفية .
7 في المعاينة لنسخ المستويات الكلاسيكية التي تم إنشاؤها بدءا من يناير 2026. تواصل مع الدعم لتفعيل نسخ المستويات الكلاسيكية الحالية.
واجهات برمجة تطبيقات الواجهة الخلفية
| دعم الميزات | Classic | V2 | Consumption | Self-hosted | Workspace |
|---|---|---|---|---|---|
| مواصفات OpenAPI | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| مواصفات WSDL | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| مواصفات WADL | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| تطبيق المنطق | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| خدمة التطبيق | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| تطبيق الوظائف | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| تطبيق الحاوية | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| نسيج الخدمة | مطور ، بريميوم | ❌ | ❌ | ❌ | ❌ |
| تمرير GraphQL | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| GraphQL الاصطناعية | ✔️ | ✔️ | ✔️1 | ✔️1 | ❌ |
| تمرير WebSocket | ✔️ | ✔️ | ❌ | ✔️ | ✔️ |
| تمرير gRPC | ✔️1 | ❌ | ❌ | ✔️ | ❌ |
| OData | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Azure OpenAI في نماذج Microsoft Foundry ونماذج اللغة الكبيرة | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| خادم MCP التمريري | ✔️ | ✔️ | ❌ | ✔️ | ❌ |
| تصدير واجهة برمجة تطبيقات REST كخادم MCP | ✔️ | ✔️ | ❌ | ✔️ | ❌ |
| وكيل A2A | ❌ | ✔️ | ❌ | ❌ | ❌ |
| قاطع الدائرة في الخلفية | ✔️ | ✔️ | ❌ | ✔️ | ✔️ |
| تجمع خلفية متوازن التحميل | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
1 في معاينة لنسخ المستويات الكلاسيكية التي تم إنشاؤها بدءا من يناير 2026. تواصل مع الدعم لتفعيل نسخ المستويات الكلاسيكية الحالية.
Policies
تدعم البوابات المدارة والمستضافة ذاتياً جميع النهج المتوفرة في تعريفات النهج مع الاستثناءات التالية. راجع مرجع النهج للحصول على تفاصيل حول كل نهج.
| دعم الميزات | Classic | V2 | Consumption | Self-hosted1 | Workspace |
|---|---|---|---|---|---|
| تكامل Dapr | ❌ | ❌ | ❌ | ✔️ | ❌ |
| تكامل ناقل خدمة Microsoft Azure (معاينة) | ✔️ | ✔️ | ✔️ | ❌ | ❌ |
| محللات GraphQL والتحقق من صحة GraphQL | ✔️ | ✔️ | ✔️ | ❌ | ❌ |
| الحصول على سياق التخويل | ✔️ | ✔️ | ✔️ | ❌ | ❌ |
| المصادقة باستخدام الهوية المدارة | ✔️ | ✔️ | ✔️ | ✔️ | ❌ |
| التخزين المؤقت الدلالي ل Azure OpenAI و LLM | ✔️ | ✔️ | ✔️ | ❌ | ❌ |
| الحصة النسبية وحد المعدل | ✔️ | ✔️ | ✔️2 | ✔️3 | ✔️ |
1 يتم تخطي النهج المكونة التي لا تدعمها البوابة المستضافة ذاتيا أثناء تنفيذ النهج.
2 لا يتوفر حد المعدل حسب المفتاح والحصة النسبية حسب المفتاح ونهج حد الرمز المميز الذكاء الاصطناعي في مستوى الاستهلاك.
3 يمكن تكوين عدد حدود المعدلات في بوابة مستضافة ذاتيا للمزامنة محليا (بين مثيلات البوابة عبر عقد نظام المجموعة)، على سبيل المثال، من خلال نشر مخطط Helm ل Kubernetes أو باستخدام قوالب توزيع مدخل Azure. ومع ذلك، لا تتم مزامنة عدد حدود المعدل مع موارد البوابة الأخرى التي تم تكوينها في مثيل APIM، بما في ذلك البوابة المدارة في السحابة.
معرفة المزيد
Monitoring
للحصول على تفاصيل حول خيارات المراقبة، راجع إمكانية المراقبة في Azure APIM.
| دعم الميزات | Classic | V2 | Consumption | Self-hosted | Workspace |
|---|---|---|---|---|---|
| تحليلات واجهة برمجة التطبيقات | ✔️ | ✔️1 | ❌ | ❌ | ❌ |
| Application Insights | ✔️ | ✔️ | ✔️ | ✔️2 | ✔️ |
| التسجيل عبر مراكز الأحداث | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| المقاييس في Azure Monitor | ✔️ | ✔️ | ✔️ | ✔️ | ❌ |
| جامع OpenTelemetry | ❌ | ❌ | ❌ | ✔️ | ❌ |
| سجلات الطلب في Azure Monitor وLog Analytics | ✔️ | ✔️ | ❌ | ❌ 3 | ❌ |
| القياسات والسجلات المحلية | ❌ | ❌ | ❌ | ✔️ | ❌ |
| طلب تتبع | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
1 تدعم المستويات v2 التحليلات المستندة إلى Azure Monitor.
تستخدم 2 Gateway مخزن الذاكرة المدمج في Azure Application Insights ولا توفر ضمانات التسليم.
3 لا ترسل البوابة المستضافة ذاتيا حاليا سجلات الموارد (سجلات التشخيص) إلى Azure Monitor.
إرسال المقاييس إلى Azure Monitor اختيارياً، أو تكوين السجلات والاحتفاظ بها محلياً حيث يتم نشر البوابة المستضافة ذاتياً.
المصادقة والتخويل
تدعم البوابات المدارة والمستضافة ذاتيا جميع خيارات المصادقة والتخويل لواجهة برمجة التطبيقات المتوفرة مع الاستثناءات التالية.
| دعم الميزات | Classic | V2 | Consumption | Self-hosted | Workspace |
|---|---|---|---|---|---|
| مدير الاعتماد | ✔️ | ✔️ | ✔️ | ❌ | ❌ |
معدل النقل والتحجيم للبوابة
Important
تعتمد نسبة النقل على عوامل عديدة، منها عدد ومعدل الاتصالات المتزامنة مع العملاء، نوع وعدد السياسات المكونة، أحجام الحمولة، أداء واجهة برمجة التطبيقات الخلفية، وعوامل أخرى. تعتمد نسبة نقل البوابة المستضافة ذاتيا أيضا على سعة الحوسبة (وحدة المعالجة المركزية والذاكرة) للمضيف الذي تعمل فيه. لتحديد معدل النقل المتوقع بدقة، قم بإجراء اختبار تحميل البوابة باستخدام ظروف الإنتاج المتوقعة.
البوابة المدارة
للحصول على الحد الأقصى المقدر لمعدل نقل البوابة في مستويات خدمة APIM، راجع تسعير APIM.
Important
استخدم أرقام النقل فقط للمعلومات. لا تعتمد عليهم في تخطيط السعة والميزانية. راجع تسعير APIM للحصول على التفاصيل.
المستويات الكلاسيكية
مستويات الإصدار 2
- قم بتحجيم سعة البوابة عن طريق إضافة وحدات المقياس وإزالتها، أو ترقية مستوى الخدمة.
- يمكنك تكوين Azure Monitor التلقائي بشكل اختياري.
مستوى الاستهلاك
- تتغير سعة مثيلات APIM في مستوى الاستهلاك تلقائياً استناداً إلى نسبة استخدام الشبكة.
بوابة مستضافة ذاتيا
- في بيئات مثل Kubernetes، أضف نسخاً متماثلة متعددة للبوابة للتعامل مع الاستخدام المتوقع.
- تكوين التحجيم التلقائي اختيارياً لتلبية متطلبات نسبة استخدام الشبكة.
بوابة مساحة العمل
قياس السعة عن طريق إضافة وحدات المقياس وإزالتها في بوابة مساحة العمل.
حدود وقت تشغيل البوابة
الجدول التالي يسرد الحدود التي تنطبق على بوابة إدارة واجهة برمجة التطبيقات عند التعامل مع طلبات واستجابات واجهة برمجة التطبيقات (API).
| حد مدة التشغيل | Classic | V2 | Consumption |
|---|---|---|---|
| الاتصالات الخلفية المتزامنة1 لكل مرجع HTTP | 2,0482 لكل وحدة | 2,048 | Unlimited |
| حجم الاستجابة المخزنة مؤقتا | 2 ميجابايت | 2 ميجابايت | 2 ميجابايت |
| حجم مستند النهج | 512 كيبيبايت | 512 كيبيبايت | 16 كيبيبايت |
| حجم حمولة الطلب | Unlimited | 1 جيجابيت | 1 جيجابيت |
| حجم الحمولة المخزنة مؤقتا | 500 ميجابايت | 2 ميجابايت | 2 ميجابايت |
| حجم حمولة الطلب/الاستجابة في سجلات التشخيص | 8,192 بايت | 8,192 بايت | 8,192 بايت |
| حجم رابط الطلب3 | Unlimited | 16,384 بايت | 16,384 بايت |
| طول مقطع مسار عنوان URL | 1,024 حرفا | 1,024 حرفا | 1,024 حرفا |
| طول القيمة المسماة | 4,096 حرفا | 4,096 حرفا | 4,096 حرفا |
| حجم نص الطلب أو الاستجابة في سياسة التحقق من صحة المحتوى | 100 كيلو بايت | 100 كيلو بايت | 100 كيلو بايت |
| حجم مخطط واجهة برمجة التطبيقات المستخدم بواسطة نهج التحقق من الصحة | 4 ميغابايت | 4 ميغابايت | 4 ميغابايت |
| إجمالي مدة الطلب | Unlimited | 30 ثانية | 30 ثانية |
| اتصالات WebSocket النشطة لكل وحدة4 | 5,000 | 5,000 | غير متوفر |
1 يتم تجميع الاتصالات وإعادة استخدامها ما لم تغلقها الواجهة الخلفية بشكل صريح.
الحد الأقصى 2 هو 1,024 في مستوى المطورين.
3 يتضمن سلسلة استعلام تصل إلى 2048 بايت.
4 حتى 60,000 اتصال كحد أقصى لكل نسخة خدمة.
نقطة نهاية فحص الصحة في Gateway
في جميع المستويات باستثناء طبقة الاستهلاك، يوفر Azure API Management نقطة نهاية مدمجة لفحص الصحة عند المسار /status-0123456789abcdef. وصل إلى هذه النقطة الطرفية للمساعدة في التأكد من أن بوابة API متاحة وتعمل بشكل صحيح. لا يختبر واجهات برمجة التطبيقات الخلفية، فقط البوابة نفسها.
يعيد الطلب إلى نقطة النهاية استجابة 200 OK HTTP عندما تكون البوابة سليمة؛ وتشير الأعطال إلى مشاكل في الشبكة أو البوابة.
- يستخدم Azure هذه النقطة الطرفية داخليا للمراقبة المستمرة لمعايير مستوى الخدمة والتحقق من صحة البوابة.
- يمكن للعملاء دمج الطلبات إلى هذه النقطة النهائية في أدوات المراقبة والمجسات الخاصة بهم.
- النقطة النهائية متاحة للبوابات المدارة (بما في ذلك البوابات الإقليمية في عمليات نشر متعددة المناطق)، وبوابات المستضافة ذاتيا، وبوابات مساحة العمل.
تلميح
عند دمج Azure Application Insights مع إدارة واجهات برمجة التطبيقات، يمكنك تفعيل مراقبة التوفر للبوابة بشكل اختياري. يقوم هذا الإعداد بإجراء استطلاع بانتظام لنقطة نهاية فحص الصحة في بوابة البوابة ويبلغ عن النتائج في تبويب التوفر في Application Insights.
المحتوى ذو الصلة
تعلم المزيد عن:
- إدارة واجهة برمجة التطبيقات في عالم مختلط ومتعدد السحابة
- مقياس السعة لاتخاذ قرارات التحجيم
- قدرات المراقبة في APIM
- قدرات البوابة الذكاء الاصطناعي في APIM