احصل على إجابات للأسئلة الشائعة حول Azure API Management.
ماذا يعني عندما تكون الميزة قيد المعاينة؟
عندما تكون الميزة قيد المعاينة، فهذا يعني أننا نسعى بنشاط للحصول على ملاحظات حول كيفية عمل الميزة نيابة عنك. اكتملت الميزة في المعاينة وظيفيا، ولكن من الممكن أن نغيرها استجابة لملاحظات العملاء. نوصي بعدم الاعتماد على ميزة قيد المعاينة في بيئة الإنتاج الخاصة بك.
كيف يمكنني معرفة التحديثات والتغييرات في APIM؟
اشترك في تحديث الإعلانات المنشورة في هذه المواقع:
كيف يمكنني تأمين الاتصال بين بوابة APIM وخدمات الواجهة الخلفية الخاصة بي؟
لديك العديد من الخيارات لتأمين الاتصال بين بوابة APIM وخدمات الواجهة الخلفية، بما في ذلك:
- استخدم مصادقة مفتاح الاشتراك. من تلقاء نفسه، مفتاح الاشتراك ليس شكلا قويا من أشكال المصادقة، ولكن غالبا ما يتم استخدامه جنبا إلى جنب مع طريقة أخرى. لمزيد من المعلومات، راجع المصادقة والتخويل في APIM.
- استخدم مصادقة TLS المتبادلة كما هو موضح في كيفية تأمين الخدمات الخلفية باستخدام مصادقة شهادة العميل في Azure API Management.
- استخدم تصفية IP على الخدمة الخلفية. في جميع مستويات APIM باستثناء مستوى الاستهلاك، يظل عنوان IP للبوابة ثابتا. لمزيد من المعلومات، راجع عناوين IP لإدارة واجهة برمجة تطبيقات Azure.
- قم بتوصيل مثيل APIM الخاص بك بشبكة Azure الظاهرية.
- تكوين تخويل OAuth 2.0. لمزيد من المعلومات، راجع المصادقة والتخويل في APIM.
كيف يمكنني نسخ مثيل خدمة APIM الخاص بي إلى مثيل جديد؟
لديك العديد من الخيارات، بما في ذلك:
- استخدم وظيفة النسخ الاحتياطي والاستعادة في APIM.
- قم بإنشاء ميزة النسخ الاحتياطي والاستعادة الخاصة بك باستخدام API Management REST API لحفظ الكيانات واستعادتها من مثيل الخدمة الذي تريده.
- قم بتنزيل تكوين الخدمة باستخدام Git، ثم قم بتحميله إلى مثيل جديد.
هل يمكنني نقل مثيل APIM من اشتراك إلى آخر؟
نعم. لمعرفة كيفية إجراء ذلك، راجع نقل الموارد إلى مجموعة موارد جديدة أو اشتراك جديد.
هل يمكنني إدارة مثيل APIM الخاص بي برمجيا؟
نعم، يمكنك إدارة APIM برمجيا باستخدام مجموعة متنوعة من الأدوات، بما في ذلك:
- واجهة برمجة تطبيقات REST لإدارة واجهة برمجة التطبيقات
- حزم SDK لعميل Azure ل .NETوJavaScriptوJava واللغات الأخرى
- Azure PowerShell و Azure CLI
- Azure Resource Manager وملفات Bicep. راجع مثال قوالب التشغيل السريع.
- Terraform
كيف يمكنني إضافة مستخدم إلى مجموعة المسؤولين؟
مجموعة المسؤولين هي مجموعة نظام غير قابلة للتغيير تتضمن مسؤولي اشتراك 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 في عمليات التوزيع إلى مواقع جغرافية متعددة؟
تستخدم APIM أسلوب توجيه نسبة استخدام الشبكة للأداء (أقل زمن انتقال) في عمليات النشر إلى مواقع جغرافية متعددة. لمزيد من المعلومات، راجع نشر مثيل Azure API Management إلى مناطق Azure متعددة.
هل تعمل APIM مع Azure ExpressRoute؟
نعم.
ما الحد الأدنى لحجم الشبكة الفرعية المطلوب عند نشر إدارة واجهة برمجة التطبيقات في شبكة ظاهرية؟
الحد الأدنى لحجم الشبكة الفرعية اللازمة لنشر APIM هو /29. تعرف على المزيد حول استخدام APIM في الشبكات الظاهرية.
هل توفر APIM جدار حماية تطبيق ويب (WAF)؟
بينما لا تتضمن APIM مكون WAF، يوصى بنشر مصدر WAF (أمام) مثيل APIM. على سبيل المثال، استخدم بوابة تطبيق Azure أو Azure Front Door.
ما هي الاختلافات بين البوابة المدارة والبوابة المستضافة ذاتيا؟
للحصول على معلومات، راجع بوابة API في 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 بعد إنشائها. ومع ذلك، يمكنك تغيير اسم العرض.
عند استنساخ واجهة برمجة تطبيقات، يتم إنشاء المثيل الجديد بقيمة تم إنشاؤها بواسطة النظام للاسم، والتي لا يمكنك تغييرها. لتحديد اسم لواجهة برمجة التطبيقات، قم بإنشاء واجهة برمجة تطبيقات جديدة يدويا واستيراد تعريف واجهة برمجة التطبيقات. لمزيد من المعلومات، راجع استيراد واجهة برمجة تطبيقات.
هل يمكنني دمج Azure API Management مباشرة مع حلول قاعدة بيانات Azure؟
نعم، يمكنك دمج Azure API Management مباشرة مع خدمات Azure الأخرى دون وسيط. على سبيل المثال، يمكن أن تتكامل إدارة واجهة برمجة تطبيقات Azure مباشرة مع واجهات برمجة تطبيقات AZURE Cosmos DB REST لعمليات CRUD، ما يلغي الحاجة إلى خدمات وسيطة مثل Azure Functions.