مشاركة عبر

إيقاف إصدار واجهة برمجة التطبيقات (يونيو 2024)

  • مقالة

ينطبق على: الاستهلاك | المطور | أساسي | قياسي | بريميوم

Azure APIM يستخدم Azure Resource Manager (ARM) لتكوين مثيلات APIM. إصدار واجهة برمجة التطبيقات مُضمن في استخدامك للقوالب التي تصف البنية الأساسية والأدوات المُستخدمة لتكوين الخدمة والبرامج التي تكتبها لإدارة خدمات Azure APIM.

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

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

على الرغم من أن خدمتك لا تتأثر بهذا التغيير، فإن أي أداة أو برنامج نصي أو برنامج يستخدم Azure Resource Manager (مثل Azure CLI أو Azure PowerShell أو Azure API Management DevOps Resource Kit أو Terraform) للتفاعل مع خدمة APIM واستدعاء إصدار API Management API قبل 2021-08-01 يتأثر بهذا التغيير. بعد إيقاف إصدار واجهة برمجة التطبيقات، لن تتمكن من تشغيل أي أدوات متأثرة بنجاح ما لم تقم بتحديث الأدوات.

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

سيتم إيقاف إصدارات واجهة برمجة التطبيقات المتأثرة تدريجيا بدءا من 1 يونيو 2024.

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

الإجراء المطلوب

قم بتحديث الأدوات والبرامج النصية والبرامج باستخدام التفاصيل الموجودة في القسم التالي.

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

تحديث الأدوات والبرامج النصية والبرامج

  • قوالب ARM أو Bicep أو Terraform - حدّث القالب لاستخدام إصدار واجهة برمجة التطبيقات 2021-08-01 أو إصدار أحدث.

  • Azure CLI - شغّل az version للتحقق من الإصدار. إذا كنت تقوم بتشغيل الإصدار 2.42.0 أو أحدث، فلا يلزم اتخاذ أي إجراء. استخدم الأمر az upgrade لترقية Azure CLI إذا لزم الأمر. لمزيد من المعلومات، راجع كيفية تحديث Azure CLI.

  • Azure PowerShell - شغّل Get-Module -ListAvailable -Name Az للتحقق من الإصدار. لا داعي لاتخاذ أي إجراء إذا كنت تُشغل الإصدار 8.1.0 أو إصدار أحدث. استخدم Update-Module -Name Az -Repository PSGallery لتحديث الوحدة إذا لزم الأمر. للحصول على مزيدٍ من المعلومات، راجع Install the Azure Az PowerShell module.

  • أدوات أخرى - استخدم الإصدارات التالية (أو إصدارات أحدث):

    • API Management DevOps Resource Kit: 1.0.0
    • موفّر Terraform azurerm: 3.0.0

  • Azure SDKs - تحديث حزم SDK لإدارة واجهة برمجة تطبيقات Azure إلى أحدث الإصدارات أو على الأقل الإصدارات التالية:

    • .NET: v1.1.0
    • Go: 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-beta3

تحديث إعداد الحد الأدنى لإصدار واجهة برمجة التطبيقات على مثيل APIM

نوصي بتعيين الحد الأدنى لإصدار واجهة برمجة التطبيقات لمثيل إدارة واجهة برمجة التطبيقات باستخدام مدخل Microsoft Azure أو استخدام واجهة برمجة تطبيقات REST أو أدوات أخرى. يحد هذا الإعداد من استدعاءات واجهة برمجة تطبيقات مستوى التحكم إلى المثيل الخاص بك إلى إصدار API يساوي أو أحدث من هذه القيمة. من خلال تعيين هذه القيمة إلى 2021-08-01، يمكنك تقييم تأثير إيقاف إصدار واجهة برمجة التطبيقات على الأدوات الخاصة بك.

لتعيين الحد الأدنى لإصدار واجهة برمجة التطبيقات في المدخل:

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
  2. في القائمة اليسرى، ضمن Deployment + infrastructure، حدد Management API.
  3. حدد علامة التبويب Management API settings.
  4. ضمن فرض الحد الأدنى لإصدار واجهة برمجة التطبيقات، حدد نعم. يظهر الحد الأدنى لإصدار واجهة برمجة التطبيقات.
  5. حدد حفظ.

هام

إذا كان الحد الأدنى لإصدار واجهة برمجة التطبيقات في المدخل رمادي اللون، يمكنك فقط تحديث الإعداد برمجيا، على سبيل المثال، باستخدام واجهة برمجة تطبيقات REST أو الأمر az apim update في Azure CLI.

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

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

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