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