مشاركة عبر

مرجع نهج إدارة APIM واجهة برمجة التطبيقات

  • مقالة

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

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

مزيد من المعلومات عن النهج:

هام

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

تحديد المعدل والحصص النسبية

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
تحديد معدل المكالمة حسب الاشتراك يمنع ارتفاعات استخدام واجهة برمجة التطبيقات عن طريق الحد من معدل الاستدعاء، على أساس كل اشتراك. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تحديد معدل المكالمة حسب المفتاح يمنع ارتفاعات استخدام واجهة برمجة التطبيقات عن طريق الحد من معدل الاستدعاء، على أساس كل مفتاح. ‏‏نعم‬ نعم لا ‏‏نعم‬
تعيين الحصة النسبية للاستخدام حسب الاشتراك يسمح لك بفرض حجم استدعاء متجدد أو مدى الحياة و/أو حصة عرض النطاق الترددي، على أساس كل اشتراك. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تعيين الحصة النسبية للاستخدام حسب المفتاح يسمح لك بفرض حجم استدعاء متجدد أو مدى الحياة و/أو حصة عرض النطاق الترددي، على أساس كل مفتاح. ‏‏نعم‬ لا لا ‏‏نعم‬
الحد من التزامن يمنع تنفيذ النهج المغلقة بأكثر من عدد الطلبات المحدد في كل مرة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
الحد من استخدام الرمز المميز لخدمة Azure OpenAI يمنع ارتفاعات استخدام واجهة برمجة تطبيقات Azure OpenAI عن طريق الحد من الرموز المميزة لنموذج اللغة الكبيرة لكل مفتاح محسوب. ‏‏نعم‬ نعم لا لا
الحد من استخدام الرمز المميز لواجهة برمجة التطبيقات لنموذج لغة كبيرة يمنع ارتفاعات استخدام واجهة برمجة تطبيقات نموذج اللغة الكبيرة (LLM) عن طريق الحد من رموز LLM المميزة لكل مفتاح محسوب. ‏‏نعم‬ نعم لا لا

المصادقة والتخويل

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
التحقق من رأس HTTP يفرض وجود و/أو قيمة عنوان HTTP. ‏‏نعم‬ نعم نعم ‏‏نعم‬
الحصول على سياق التخويل يحصل على سياق التخويل لاتصال محدد بموفر بيانات اعتماد تم تكوينه في مثيل APIM. ‏‏نعم‬ نعم نعم لا
Restrict caller IPs عوامل التصفية (تسمح/ترفض) المكالمات من عناوين IP و/أو نطاقات عناوين محددة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
التحقق من صحة الرمز المميز ل Microsoft Entra يفرض وجود وصلاحية Microsoft Entra (المعروف سابقا باسم Azure Active Directory) JWT المستخرج إما من عنوان HTTP محدد أو معلمة استعلام أو قيمة رمز مميز. ‏‏نعم‬ نعم نعم ‏‏نعم‬
التحقق من صحة JWT يفرض وجود وصلاحية JWT المستخرجة إما من رأس HTTP محدد أو معلمة استعلام أو قيمة رمز مميز. ‏‏نعم‬ نعم نعم ‏‏نعم‬
التحقق من صحة شهادة العميل يفرض أن الشهادة المقدمة من قبل العميل إلى مثيل APIM تطابق قواعد ومطالبات التحقق المحددة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
المصادقة باستخدام Basic المصادقة باستخدام خدمة الواجهة الخلفية باستخدام المصادقة الأساسية. ‏‏نعم‬ نعم نعم ‏‏نعم‬
المصادقة باستخدام شهادة العميل المصادقة باستخدام خدمة الواجهة الخلفية باستخدام شهادات العميل. ‏‏نعم‬ نعم نعم ‏‏نعم‬
المصادقة باستخدام الهوية المدارة المصادقة باستخدام خدمة الواجهة الخلفية باستخدام هوية مدارة. ‏‏نعم‬ نعم نعم ‏‏نعم‬

التحقق من صحة المحتوى

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
التحقق من صحة المحتوى التحقق من حجم أو محتوى نص طلب أو استجابة مقابل مخطط API واحد أو أكثر. تنسيقات المخطط المدعومة هي JSON وXML. ‏‏نعم‬ نعم نعم ‏‏نعم‬
Validate GraphQL request التحقق من صحة طلب وتخويله إلى API GraphQL. ‏‏نعم‬ نعم نعم ‏‏نعم‬
التحقق من صحة طلب OData التحقق من صحة طلب إلى واجهة برمجة تطبيقات OData لضمان التوافق مع مواصفات OData. ‏‏نعم‬ نعم نعم ‏‏نعم‬
التحقق من صحة المعلمات التحقق من صحة معلمات عنوان الطلب أو الاستعلام أو المسار مقابل مخطط واجهة برمجة التطبيقات. ‏‏نعم‬ نعم نعم ‏‏نعم‬
التحقق من صحة الرؤوس التحقق من صحة رؤوس الاستجابة مقابل مخطط واجهة برمجة التطبيقات. ‏‏نعم‬ نعم نعم ‏‏نعم‬
التحقق من صحة رمز الحالة التحقق من صحة رموز حالة HTTP في الاستجابات مقابل مخطط واجهة برمجة التطبيقات. ‏‏نعم‬ نعم نعم ‏‏نعم‬

التوجيه

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
إعادة توجيه الطلب إعادة توجيه الطلب إلى خدمة الواجهة الخلفية. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تعيين خدمة الواجهة الخلفية تغيير عنوان URL الأساسي للخدمة الخلفية لطلب وارد إلى عنوان URL أو خلفية. يسمح لك الرجوع إلى مورد الواجهة الخلفية بإدارة عنوان URL الأساسي للخدمة الخلفية والإعدادات الأخرى في مكان واحد. نفذ أيضا موازنة تحميل نسبة استخدام الشبكة عبر مجموعة من خدمات الواجهة الخلفية وقواعد قاطع الدوائر لحماية الواجهة الخلفية من عدد كبير جدا من الطلبات. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تعيين وكيل HTTP يسمح لك بتوجيه الطلبات التي تمت إعادة توجيهها عبر وكيل HTTP. ‏‏نعم‬ نعم نعم ‏‏نعم‬

التخزين المؤقت

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
الحصول على من ذاكرة التخزين المؤقت إجراء بحث عن ذاكرة التخزين المؤقت وإرجاع استجابة مخزنة مؤقتا صالحة عند توفرها. ‏‏نعم‬ نعم نعم ‏‏نعم‬
التخزين إلى ذاكرة التخزين المؤقت استجابة ذاكرة التخزين المؤقت وفقا لتكوين التحكم في ذاكرة التخزين المؤقت المحددة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
الحصول على قيمة من ذاكرة التخزين المؤقت استرداد عنصر مخزن مؤقتا حسب المفتاح. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تخزين القيمة في ذاكرة التخزين المؤقت يخزن عنصرا في ذاكرة التخزين المؤقت حسب المفتاح. ‏‏نعم‬ نعم نعم ‏‏نعم‬
إزالة القيمة من ذاكرة التخزين المؤقت إزالة عنصر في ذاكرة التخزين المؤقت بواسطة المفتاح. ‏‏نعم‬ نعم نعم ‏‏نعم‬
الحصول على استجابات مخزنة مؤقتا لطلبات واجهة برمجة تطبيقات Azure OpenAI إجراء البحث في ذاكرة التخزين المؤقت لواجهة برمجة تطبيقات Azure OpenAI باستخدام البحث الدلالي وإرجاع استجابة مخزنة مؤقتا صالحة عند توفرها. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تخزين استجابات طلبات واجهة برمجة تطبيقات Azure OpenAI للتخزين المؤقت ذاكرة التخزين المؤقت للاستجابة وفقا لتكوين ذاكرة التخزين المؤقت لواجهة برمجة تطبيقات Azure OpenAI. ‏‏نعم‬ نعم نعم ‏‏نعم‬
الحصول على استجابات مخزنة مؤقتا لطلبات واجهة برمجة تطبيقات نموذج اللغة الكبيرة إجراء البحث في ذاكرة التخزين المؤقت لواجهة برمجة التطبيقات لنموذج اللغة الكبيرة باستخدام البحث الدلالي وإرجاع استجابة مخزنة مؤقتا صالحة عند توفرها. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تخزين استجابات طلبات واجهة برمجة تطبيقات نموذج اللغة الكبيرة للتخزين المؤقت ذاكرة التخزين المؤقت للاستجابة وفقا لتكوين ذاكرة التخزين المؤقت لواجهة برمجة التطبيقات لنموذج اللغة الكبيرة. ‏‏نعم‬ نعم نعم ‏‏نعم‬

التحويل

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
تعيين أسلوب الطلب يسمح لك بتغيير أسلوب HTTP لطلب. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تعيين رمز الحالة تغيير رمز حالة HTTP إلى القيمة المحددة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تعيين متغير الاحتفاظ بقيمة في متغير سياق مسمى للوصول لاحقا. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تعيين النص الأساسي تعيين نص الرسالة لطلب أو استجابة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تعيين رأس HTTP تعيين قيمة إلى استجابة موجودة و/أو عنوان طلب أو إضافة استجابة و/أو عنوان طلب جديد. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تعيين معلمة سلسلة الاستعلام إضافة قيمة معلمة سلسلة استعلام الطلب أو استبدالها أو حذفها. ‏‏نعم‬ نعم نعم ‏‏نعم‬
إعادة كتابة عنوان URL تحويل عنوان URL للطلب من شكله العام إلى الشكل الذي تتوقعه خدمة الويب. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تحويل JSON إلى XML تحويل نص الطلب أو الاستجابة من JSON إلى XML. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تحويل XML إلى JSON تحويل نص الطلب أو الاستجابة من XML إلى JSON. ‏‏نعم‬ نعم نعم ‏‏نعم‬
البحث عن سلسلة في النص الأساسي واستبدالها البحث عن سلسلة فرعية لطلب أو استجابة واستبدالها بسلسلة فرعية مختلفة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
إخفاء عناوين URL في المحتوى إعادة كتابة الارتباطات (الأقنعة) في نص الاستجابة بحيث تشير إلى الارتباط المكافئ عبر البوابة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تحويل XML باستخدام XSLT تطبيق تحويل XSL على XML في نص الطلب أو الاستجابة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
استجابة العودة إحباط تنفيذ البنية الأساسية لبرنامج ربط العمليات التجارية وإرجاع الاستجابة المحددة مباشرة إلى المتصل. ‏‏نعم‬ نعم نعم ‏‏نعم‬
استجابة وهمية إحباط تنفيذ البنية الأساسية لبرنامج ربط العمليات التجارية وإرجاع استجابة وهمية مباشرة إلى المتصل. ‏‏نعم‬ نعم نعم ‏‏نعم‬

عبر المجالات

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
السماح بالمكالمات عبر المجالات يجعل واجهة برمجة التطبيقات قابلة للوصول من عملاء Adobe Flash وMicrosoft Silverlight المستندين إلى المستعرض. ‏‏نعم‬ نعم نعم ‏‏نعم‬
CORS إضافة دعم مشاركة الموارد عبر المنشأ (CORS) إلى عملية أو واجهة برمجة تطبيقات للسماح باستدعاءات عبر المجالات من العملاء المستندين إلى المستعرض. ‏‏نعم‬ نعم نعم ‏‏نعم‬
JSONP يضيف JSON مع دعم ترك مساحة (JSONP) إلى عملية أو واجهة برمجة تطبيقات للسماح باستدعاءات عبر المجالات من العملاء المستندين إلى مستعرض JavaScript. ‏‏نعم‬ نعم نعم ‏‏نعم‬

التكامل والاتصال الخارجي

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
إرسال طلب إرسال طلب إلى عنوان URL المحدد. ‏‏نعم‬ نعم نعم ‏‏نعم‬
إرسال طلب في اتجاه واحد إرسال طلب إلى عنوان URL المحدد دون انتظار استجابة. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تسجيل الدخول إلى مركز الأحداث إرسال رسائل بالتنسيق المحدد إلى مركز أحداث تم تعريفه بواسطة كيان مسجل. ‏‏نعم‬ نعم نعم ‏‏نعم‬
إرسال طلب إلى خدمة (Dapr) يستخدم وقت تشغيل Dapr لتحديد موقع خدمة Dapr المصغرة والتواصل معها بشكل موثوق. لمعرفة مزيدٍ من المعلومات حول استدعاء الخدمة في Dapr، راجع الوصف في ملف README هذا. لا لا لا ‏‏نعم‬
إرسال رسالة إلى موضوع Pub/Sub (Dapr) يستخدم وقت تشغيل Dapr لنشر رسالة إلى موضوع نشر/اشتراك. لمعرفة مزيدٍ من المعلومات حول مراسلة النشر/الاشتراك في Dapr، راجع الوصف في ملف README هذا. لا لا لا ‏‏نعم‬
ربط إخراج المشغل (Dapr) يستخدم وقت تشغيل Dapr لاستدعاء نظام خارجي عبر ربط الإخراج. لمعرفة مزيدٍ من المعلومات حول الروابط في Dapr، راجع الوصف في ملف README هذا. لا لا لا ‏‏نعم‬

تسجيل الدخول

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
Trace إضافة تتبعات مخصصة إلى إخراج تتبع الطلب في وحدة تحكم الاختبار، وبيانات تتبع استخدام Application Insights، وسجلات الموارد. ‏‏نعم‬ نعم1 ‏‏نعم‬ ‏‏نعم‬
إصدار المقاييس إرسال مقاييس مخصصة إلى Application Insights عند التنفيذ. ‏‏نعم‬ نعم نعم ‏‏نعم‬
إرسال مقاييس الرمز المميز ل Azure OpenAI يرسل مقاييس إلى Application Insights لاستهلاك الرموز المميزة لنموذج اللغة الكبيرة من خلال واجهات برمجة تطبيقات خدمة Azure OpenAI. ‏‏نعم‬ نعم لا ‏‏نعم‬
إصدار مقاييس رمز واجهة برمجة التطبيقات لنموذج لغة كبيرة يرسل مقاييس إلى Application Insights لاستهلاك الرموز المميزة لنموذج اللغة الكبيرة (LLM) من خلال واجهات برمجة تطبيقات LLM. ‏‏نعم‬ نعم لا ‏‏نعم‬

1 في بوابة V2، لا يضيف النهج trace حاليا إخراج التتبع في وحدة تحكم الاختبار.

محللات GraphQL

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
مصدر بيانات Azure SQL للمحلل تكوين طلب Azure SQL والاستجابة الاختيارية لحل البيانات لنوع عنصر وحقل في مخطط GraphQL. ‏‏نعم‬ نعم لا لا
مصدر بيانات Cosmos DB للمحلل تكوين طلب Cosmos DB والاستجابة الاختيارية لحل البيانات لنوع عنصر وحقل في مخطط GraphQL. ‏‏نعم‬ نعم لا لا
مصدر بيانات HTTP للمحلل تكوين طلب HTTP واستجابة HTTP اختياريا لحل البيانات لنوع عنصر وحقل في مخطط GraphQL. ‏‏نعم‬ نعم نعم لا
نشر الحدث إلى اشتراك GraphQL نشر حدث إلى اشتراك واحد أو أكثر محدد في مخطط واجهة برمجة تطبيقات GraphQL. تكوين النهج في محلل GraphQL لحقل ذي صلة في المخطط لنوع عملية آخر مثل الطفرة. ‏‏نعم‬ نعم نعم لا

التحكم في النهج والتدفق

النهج ‏‏الوصف كلاسيكي V2 الاستهلاك‬ مستضاف ذاتيًا
تدفق التحكم يطبق عبارات النهج بشكل مشروط استنادا إلى نتائج تقييم التعبيرات المنطقية. ‏‏نعم‬ نعم نعم ‏‏نعم‬
تضمين جزء إدراج جزء نهج في تعريف النهج. ‏‏نعم‬ نعم نعم ‏‏نعم‬
إعادة المحاولة إعادة محاولة تنفيذ عبارات النهج المغلقة، إذا وحتى يتم استيفاء الشرط. سيتم تكرار التنفيذ في الفواصل الزمنية المحددة وحتى عدد إعادة المحاولة المحدد. ‏‏نعم‬ نعم نعم ‏‏نعم‬
انتظري انتظار اكتمال طلب الإرسال المغلق أو الحصول على قيمة من ذاكرة التخزين المؤقت أو نهج تدفق التحكم قبل المتابعة. ‏‏نعم‬ نعم نعم ‏‏نعم‬

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

لمزيد من المعلومات حول العمل مع النُهج، راجع: