مشاركة عبر

مساحات العمل التي تكسر التغييرات، الجزء 2 (مارس 2025)

  • مقالة

ينطبق على: Premium

هام

تنطبق هذه التغييرات العاجلة فقط على معاينة مساحات العمل في Azure API Management. إذا قمت بإنشاء مساحات عمل بعد الإصدار المتاح بشكل عام في أغسطس 2024 واستخدام مساحات العمل مع بوابات مساحة العمل، فلا يجب أن تتأثر مساحات العمل بهذه التغييرات.

تتوفر الآن مساحات عمل Azure API Management بشكل عام، وقدمنا العديد من تحديثات الميزات مع هذا الإصدار. كجزء من التطوير المستمر لمساحات العمل، نقوم بإزالة الدعم لمساحات عمل المعاينة (التي تم إنشاؤها قبل أغسطس 2024). إذا قمت بإنشاء مساحات عمل معاينة في Azure API Management وتريد متابعة استخدامها، فستحتاج إلى ترحيل مساحات العمل إلى الإصدار المتوفر بشكل عام.

بعد 31 مارس 2025، قد تتوقف مساحات عمل المعاينة وواجهات برمجة التطبيقات المدارة فيها عن العمل إذا لم تكن قد قمت بالترحيل إلى أحدث إمكانيات مساحة العمل. لا تتأثر واجهات برمجة التطبيقات والموارد المدارة خارج مساحات العمل بهذا التغيير.

هل تتأثر خدمتي بهذه التغييرات؟

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

كسر التغييرات

فيما يلي التغييرات العاجلة التي تتطلب منك اتخاذ إجراء لترحيل مساحات عمل المعاينة إلى الإصدار المتاح بشكل عام:

  • بوابة واجهة برمجة تطبيقات مساحة العمل مطلوبة - يجب أن تكون كل مساحة عمل مقترنة ببوابة واجهة برمجة تطبيقات مساحة العمل التي تعزل حركة مرور وقت تشغيل مساحة العمل. في المعاينة، تشارك مساحات العمل بوابة مع الخدمة.
  • الهويات المدارة على مستوى الخدمة غير مدعومة - لتحسين أمان مساحات العمل، لا يمكن استخدام الهويات المدارة المعينة من قبل النظام والمخصصة من قبل المستخدم والممكنة على مستوى الخدمة في مساحات العمل. حاليا، لا يتم دعم ميزات إدارة واجهة برمجة التطبيقات ذات الصلة التي تعتمد على الهويات المدارة، مثل تخزين القيم والشهادات المسماة في Azure Key Vault، واستخدام authentication-managed-identity النهج، في مساحات العمل.

إشعار

هذه التغييرات العاجلة بالإضافة إلى التغييرات العاجلة لشهر يونيو 2024 لمساحات عمل المعاينة التي تم الإعلان عنها مسبقا.

ما هو الموعد النهائي للتغيير؟

سيتم فرض التغييرات العاجلة في مساحات عمل المعاينة بعد 31 مارس 2025. نوصي بشدة بإجراء جميع التغييرات المطلوبة على تكوين مساحات عمل المعاينة قبل ذلك التاريخ.

ماذا عليّ أن أفعل؟

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

استخدام المستوى المتميز لمثيل إدارة واجهة برمجة التطبيقات

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

تأكيد المنطقة للمثيل الخاص بك

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

لتحديد ما إذا كانت مساحة عمل المعاينة في منطقة مدعومة:

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
  2. في القائمة اليسرى، ضمن واجهات برمجة التطبيقات، حدد مساحات العمل، وحدد مساحة عمل.
  3. إذا كانت مساحة العمل الخاصة بك في منطقة لا تدعم بوابات مساحة العمل، فسترى رسالة في المدخل مشابهة ل "مساحات العمل غير متوفرة حاليا في منطقة خدمة APIM".
    • إذا رأيت هذه الرسالة، يمكنك نقل مثيل API Management إلى منطقة مدعومة.
    • إذا لم تشاهد هذه الرسالة، فإن مساحة العمل الخاصة بك في منطقة مدعومة ويمكنك المتابعة لإضافة بوابة مساحة عمل.

إضافة بوابة مساحة عمل إلى مساحة العمل الخاصة بك

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

إشعار

  • تتحمل بوابة مساحة العمل رسوما إضافية. لمزيد من المعلومات، راجع تسعير APIM.
  • تدعم APIM حاليا بوابة مخصصة لكل مساحة عمل فقط. إذا كان هذا يؤثر على خطط الترحيل الخاصة بك، فشاهد مخطط مساحات العمل في إعلان GA لمساحات العمل.
  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
  2. في القائمة اليسرى، ضمن واجهات برمجة التطبيقات، حدد مساحات العمل.
  3. تحديد مساحة عمل.
  4. في القائمة اليسرى، ضمن Deployment + infrastructure، حدد Gateways>+ Add.
  5. أكمل المعالج لإنشاء بوابة. حاليا، يمكن أن يستغرق توفير البوابة من عدة دقائق إلى ما يصل إلى 3 ساعات أو أكثر.
  6. بعد توفير البوابة، انتقل إلى صفحة نظرة عامة على البوابة. لاحظ قيمة اسم مضيف وقت التشغيل. استخدم هذه القيمة لتحديث تطبيقات العميل التي تستدعي واجهات برمجة تطبيقات مساحة العمل الخاصة بك.
  7. كرر الخطوات السابقة لمساحات العمل المتبقية.

تحديث تطبيقات العميل لاستخدام اسم مضيف البوابة الجديد

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

إشعار

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

تحديث التبعيات على الهويات المدارة على مستوى الخدمة

إذا كنت تستخدم هويات مدارة على مستوى الخدمة في تكوين كيانات مساحة العمل (على سبيل المثال، القيم أو الشهادات المسماة)، فأنت بحاجة إلى تحديث التكوينات. تختلف الخطوات الموصى بها وفقا للكيان. مثال: تحديث القيم المسماة لاستخدام القيم السرية بدلا من الأسرار المخزنة في Azure Key Vault.

الدعم والتعليمات

إذا كانت لديك أسئلة، فاحصل على إجابات من خبراء المجتمع في Microsoft Q&A. في حالة امتلاكك خطة دعم وتحتاج إلى مساعدة تقنية، أنشئ طلب الدعم.

مزيد من المعلومات

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

راجع جميع التغييرات العاجلة القادمة وحالات إيقاف الميزات.