إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تقدم هذه المقالة نظرة عامة حول سياسات تغيير الإصدارات وكسر التغيير لأدوات قابلية البرمجة المختلفة.
معلومات الدعم والإهلاك
عند إصدار إصدار جديد من واجهة برمجة تطبيقات REST، يتم إيقاف الإصدارات السابقة. تعلن Microsoft عن إهمال إصدار قبل 12 شهرا على الأقل من إيقاف نقطة نهاية واجهة برمجة التطبيقات. عند إهمال إصدار، يتم دعمه as-is. إذا واجهت مشكلة في هذا الإصدار، فإننا نطلب منك الانتقال إلى الإصدار المستقر حاليا. عند إيقاف إصدار، فإنه غير مدعوم وسيتم إيقاف تشغيله قريبا.
من خلال زيادة رقم إصدار واجهة برمجة التطبيقات (على سبيل المثال، من 2021-10-01 إلى 2022-04-01)، Microsoft يعلن أن الإصدار السابق المتاح بشكل عام (في هذا المثال، 2021-10-01) قد تم إهماله على الفور وسيتم إيقافه بعد 12 شهرا من الإعلان. وينطبق نفس هذا الأمر على الإصدار أولي للاستخدام العام. Microsoft قد يقدم استثناءات لهذا النهج لمشكلات حماية الخدمة وأمانها.
يتم تحديث الأدوات المختلفة ومجموعات SDK التي يتم إنشاؤها أعلى Power Platform API مثل Power Platform CLI وموصل Admin V2 وPowerShell إلى إصدارات API أحدث على أساس كل إجراء وتكون شفافة للمستخدمين النهائيين.
التغييرات المتوافقة والعاجلة
توفر Microsoft تفاصيل تغييرات قابلية البرمجة في خطط الإصدار. إذا كانت التغييرات غير منكسرة بطبيعتها، فسيظل إصدار واجهة برمجة التطبيقات كما هو، ويتلقى إصدار PowerShell زيادة إصدار ثانوية. إذا كانت التغييرات تتعطل بطبيعتها، فإن Microsoft تقوم بزيادة إصدار واجهة برمجة التطبيقات والإصدار الرئيسي ل PowerShell.
فيما يلي أمثلة على التغييرات العاجلة:
- تم تغيير عنوان URL أو الطلب/الاستجابة الأساسية.
- تتم إزالة الخاصية المُعلنة أو إعادة تسميتها، أو تغيير نوعها.
- تتم إزالة أو إعادة تسمية معلمات API أو API.
- تمت إضافة معلمة الطلب المطلوبة.
فيما يلي أمثلة على التغييرات غير المكسرة:
- يتم إضافة الخصائص التي تكون خالية أو لها قيمة افتراضية.
- يتم إضافة عضو إلى التعداد.
- يتم تقديم الترحيل إلى المجموعات الموجودة.
- تم تغيير رموز الخطأ.
- تم تغيير ترتيب الخصائص في الطلبات أو الردود.
الإصدارات المتوفرة
| الإصدار | نوع | المرجع | تاريخ الإهمال | تاريخ إيقاف التشغيل |
|---|---|---|---|---|
| 2024-10-01 | مستقر | مرجع | غير متوفر | غير متوفر |
| 2022-03-01-preview | إصدار أولي للاستخدام العام | 2022-03-01-معاينة المرجع | 2025-03-01 | 2026-03-01 |
| 2020-10-01 | متوفر بشكل عام | 2020-10-01 المرجع | غير متوفر | غير متوفر |
ملاحظة
الإصدار المتوفر بشكل عام 2020-10-01 من واجهة API في Power Platform يتعلق بإدارة البيئة ويُشار إليها عادة باسم واجهة API للنظام الأساسي لتطبيقات الأعمال (BAP). يتم توفير وظائف هذه المجموعة من نقاط النهاية في الإصدارات الأحدث من Power Platform API جنبا إلى جنب مع العديد من الميزات الإضافية بعد الإصدار 2022-03-01-preview.
الخطوات التالية
الآن بعد أن فهمت إستراتيجية الإصدار والدعم، دعنا نتعرف على كيفية المصادقة باستخدام واجهة API في Microsoft Power Platform.