احصل على إجابات للأسئلة الشائعة حول Azure API Management.
ماذا يعني أن الميزة قيد المعاينة؟
عندما تكون الميزة قيد المعاينة، فهذا يعني أننا نسعى بنشاط للحصول على تعليقات حول كيفية عمل الميزة لك. تكتمل وظيفيًّا إحدى الميزات الموجودة في المعاينة، ولكن من الممكن أن نجري تغييرًا جذريًّا استجابةً لملاحظات العملاء. نوصي بعدم الاعتماد على ميزة قيد المعاينة في بيئة الإنتاج الخاصة بك.
كيف أعمل تعرف على التحديثات والتغييرات التي تم إجراؤها على APIM؟
اشترك في تحديث الإعلانات المنشورة في هذه المواقع:
- ملاحظات إصدار Azure API Management.
- تحديثات Azure
كيف يمكنني تأمين الاتصال بين بوابة APIM وخدمات الواجهة الخلفية الخاصة بي؟
لديك العديد من الخيارات لتأمين الاتصال بين بوابة APIM وخدمات الواجهة الخلفية، بما في ذلك:
- استخدم مصادقة مفتاح الاشتراك. من تلقاء نفسه، مفتاح الاشتراك ليس شكلا قويا من أشكال المصادقة، ولكن غالبا ما يتم استخدامه جنبا إلى جنب مع طريقة أخرى. لمزيد من المعلومات، راجع المصادقة والتخويل في APIM.
- استخدم مصادقة TLS المتبادلة كما هو موضح في كيفية تأمين الخدمات الخلفية باستخدام مصادقة شهادة العميل في Azure API Management.
- استخدم تصفية IP على الخدمة الخلفية الخاصة بك. في جميع مستويات APIM باستثناء مستوى الاستهلاك، يظل عنوان IP للبوابة ثابتا. لمزيد من المعلومات، راجع عناوين IP لإدارة واجهة برمجة تطبيقات Azure.
- الاتصال مثيل APIM الخاص بك إلى شبكة Azure الظاهرية.
- تكوين تخويل OAuth 2.0. لمزيد من المعلومات، راجع المصادقة والتخويل في APIM.
كيف أنسخ مثيل خدمة إدارة واجهة برمجة التطبيقات (API) الخاصة بي إلى مثيل جديد؟
لديك العديد من الخيارات، بما في ذلك:
- استخدم وظيفة النسخ الاحتياطي والاستعادة في APIM.
- قم بإنشاء ميزة النسخ الاحتياطي والاستعادة الخاصة بك باستخدام API Management REST API لحفظ الكيانات واستعادتها من مثيل الخدمة الذي تريده.
- قم بتنزيل تكوين الخدمة باستخدام Git، ثم قم بتحميله إلى مثيل جديد.
هل يمكنني نقل مثيل APIM من اشتراك إلى آخر؟
نعم. لمعرفة كيفية إجراء ذلك، راجع نقل الموارد إلى مجموعة موارد جديدة أو اشتراك جديد.
هل يمكنني إدارة مثيل API Management الخاص بي برمجيًّا؟
نعم، يمكنك إدارة APIM برمجيا باستخدام مجموعة متنوعة من الأدوات، بما في ذلك:
- واجهة برمجة تطبيقات REST لإدارة واجهة برمجة التطبيقات
- حزم SDK لعميل Azure ل .NET وJavaScript وJava واللغات الأخرى
- Azure PowerShell و Azure CLI
- قوالب Azure Resource Manager وBicep. راجع مثال قوالب التشغيل السريع.
- Terraform
كيف أقوم بإضافة مستخدم إلى مجموعة المسؤولين؟
مجموعة مسؤول istrators هي مجموعة نظام غير قابلة للتغيير تتضمن مسؤولي اشتراك Azure. لا يمكنك إضافة مستخدم إلى هذه المجموعة. لمزيد من المعلومات، راجع كيفية إنشاء المجموعات واستخدامها لإدارة حسابات المطورين في Azure API Management.
لماذا لا تتوفر السياسة التي أريد إضافتها في محرر السياسة؟
إذا ظهر النهج الذي تريد إضافته باللون الرمادي أو مظلل في محرر النهج، فتأكد من أنك في النطاق الصحيح للنهج. تم تصميم كل بيان نهج للاستخدام في نطاقات وأقسام نهج معينة. لمراجعة أقسام النهج ونطاقاته لنهج ما، راجع قسم الاستخدام الخاص بالنهج في مرجع النهج.
كيف أقوم بإعداد بيئات متعددة في واجهة برمجة تطبيقات واحدة؟
لإعداد بيئات متعددة، على سبيل المثال، بيئة اختبار وبيئة إنتاج، في واجهة برمجة تطبيقات واحدة، لديك خياران. يمكنك:
- استضافة واجهات برمجة تطبيقات مختلفة على نفس مثيل APIM.
- استضافة نفس واجهات برمجة التطبيقات على مثيلات مختلفة.
هل تدعم APIM الواجهات الخلفية لواجهة برمجة تطبيقات REST فقط؟
تدعم APIM واجهات برمجة تطبيقات REST بالإضافة إلى المرور إلى واجهات برمجة تطبيقات SOAP وWebSocket وGraphQL. تدعم APIM أيضا واجهات برمجة تطبيقات GraphQL الاصطناعية.
تتكامل APIM أيضا مع عروض حوسبة Azure شائعة الاستخدام لإنشاء واستضافة واجهات برمجة التطبيقات على Azure، بما في ذلك الوظائف وتطبيقات المنطق وتطبيقات الحاويات وتطبيقات الويب.
هل هناك قيود على استيراد واجهة برمجة التطبيقات الخاصة بي؟
راجع قيود استيراد واجهة برمجة التطبيقات والمشكلات المعروفة لتنسيقات OpenAPI (Swagger) وWSDL وWADL.
هل يمكنني استخدام CI/CD لتطوير واجهة برمجة التطبيقات؟
نعم. لمزيد من المعلومات، راجع استخدام DevOps وCI/CD لنشر واجهات برمجة التطبيقات.
للحصول على إرشادات معمارية، راجع مسرع المنطقة المنتقل إليها في Azure API Management.
ما طريقة التوجيه التي تستخدمها إدارة واجهة برمجة التطبيقات في عمليات النشر إلى مواقع جغرافية متعددة؟
تستخدم APIM أسلوب توجيه نسبة استخدام الشبكة للأداء (أقل زمن انتقال) في عمليات النشر إلى مواقع جغرافية متعددة. لمزيد من المعلومات، راجع نشر مثيل Azure API Management إلى مناطق Azure متعددة.
هل تعمل إدارة API مع Azure ExpressRoute؟
نعم.
ما الحد الأدنى لحجم الشبكة الفرعية المطلوب عند نشر إدارة واجهة برمجة التطبيقات في شبكة ظاهرية؟
الحد الأدنى لحجم الشبكة الفرعية اللازمة لنشر APIM هو /29. تعرف على المزيد حول استخدام APIM في الشبكات الظاهرية.
هل توفر APIM جدار حماية تطبيق ويب (WAF)؟
بينما لا تتضمن APIM مكون WAF، يوصى بنشر مصدر WAF (أمام) مثيل APIM. على سبيل المثال، استخدم بوابة تطبيق Azure أو Azure Front Door.
ما هي الاختلافات بين البوابة المدارة والبوابة المستضافة ذاتيا؟
للحصول على معلومات، راجع بوابة API في APIM ونظرة عامة على البوابة ذاتية الاستضافة.
كيف تتعامل APIM مع الشرطة المائلة اللاحقة عند استدعاء خدمات الواجهة الخلفية؟
تاريخيا وبالاصطلاح يتم التعامل مع عنوان URL الذي ينتهي بشرطة مائلة لاحقة كدليل، على سبيل المثال https://contoso.com/sample/
، في حين أن عنوان URL نفسه بدون الشرطة https://contoso.com/sample
المائلة اللاحقة قد يشير إلى ملف. هذا غير مخول؛ تعتبر بعض الأنظمة هذين عنواني URL فريدين، والبعض الآخر يعتبرهما متشابهين. لا تميز APIM، وبالتالي فإن عملية resource
واحدة ستقبل إما resource
أو resource/
. ومع ذلك، قد يكون التمييز مهما لمضيف الواجهة الخلفية. ستقوم بعض خوادم الويب تلقائيًا بإعادة توجيه عنوان URL لا ينتهي بشرطة مائلة لاحقة، إلى نفس عنوان URL الذي ينتهي بشرطة مائلة لاحقة. نظرا لأن API Management هي العميل إلى الخلفية (الخادم)، فإن إعادة التوجيه التلقائية ليست مرغوبة دائما. إذا لزم الأمر، قم بإنشاء نهج إعادة كتابة عنوان URL لضمان إضافة شرطة مائلة زائدة دائما إلى استدعاء الواجهة الخلفية الصادرة.
هل يمكن تغيير اسم API Management API؟
لا، لا يمكنك تغيير اسم (أو معرف) واجهة برمجة التطبيقات في Azure API Management بعد إنشائها. ومع ذلك، يمكنك تغيير اسم العرض.
عند استنساخ واجهة برمجة تطبيقات، يتم إنشاء المثيل الجديد بقيمة تم إنشاؤها بواسطة النظام للاسم، والتي لا يمكنك تغييرها. لتحديد اسم لواجهة برمجة التطبيقات، قم بإنشاء واجهة برمجة تطبيقات جديدة يدويا واستيراد تعريف واجهة برمجة التطبيقات. لمزيد من المعلومات، راجع استيراد واجهة برمجة تطبيقات.