الترحيل من Azure Enterprise Reporting إلى نظرة عامة على Microsoft Cost Management APIs

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

النقاط الرئيسية:

  • يوصى بالترحيل - نوصي بشدة بمراعاة ترحيل الحلول المخصصة إلى واجهات برمجة تطبيقات Microsoft Cost Management. يتم تطويرها بنشاط وتوفر وظائف محسنة.
  • تاريخ الإيقاف - يتم إيقاف جميع واجهات برمجة تطبيقات Azure Enterprise Reporting.

توفر هذه المقالة:

  • نظرة عامة على الاختلافات بين واجهات برمجة التطبيقات لتقارير Azure Enterprise وواجهات برمجة التطبيقات لإدارة التكاليف.
  • إرشادات حول ما يمكن توقعه عند الترحيل إلى واجهات برمجة تطبيقات إدارة التكلفة.
  • نظرة ثاقبة على القدرات الجديدة المتوفرة مع واجهات برمجة تطبيقات إدارة التكلفة.

دعوة لاتخاذ إجراء:

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

اختلافات واجهات برمجة التطبيقات

تصف المعلومات التالية الاختلافات بين واجهات برمجة تطبيقات Azure Enterprise Reporting الأقدم وواجهات برمجة تطبيقات إدارة التكلفة الأحدث.

استخدام واجهات برمجة تطبيقات تقارير مؤسسة Azure واجهات برمجة تطبيقات إدارة التكاليف من Microsoft
المصادقة مفتاح واجهة برمجة التطبيقات المتوفر في مدخل Microsoft Azure مصادقة Microsoft Entra باستخدام رموز المستخدم المميزة أو أساسيات الخدمة. يحل كيان الخدمة محل مفاتيح واجهة برمجة التطبيقات.
النطاقات والأذونات جميع الطلبات في نطاق التسجيل. ستحدد تعيينات أذونات مفاتيح واجهة برمجة التطبيقات ما إذا كان سيتم إرجاع بيانات التسجيل بالكامل أو القسم أو الحساب المحدد. لا يوجد مصادقة المستخدم. يتم تعيين الوصول إلى نطاق التسجيل أو القسم أو الحساب للمستخدمين أو كيانات الخدمة.
نقطة نهاية عنوان URI https://consumption.azure.com https://management.azure.com
حالة التطوير لا شيء، يتم إيقاف واجهات برمجة التطبيقات. قيد التطوير النشط
واجهات برمجة التطبيقات المتاحة يقتصر على ما هو متوفر حالياً تتوفر واجهات برمجة التطبيقات المكافئة لاستبدال كل واجهة برمجة تطبيقات اتفاقية Enterprise. تتوفر أيضا واجهات برمجة تطبيقات إضافية لإدارة التكاليف، بما في ذلك:
- الموازنات
- التنبيهات
- عمليات التصدير

قائمة التحقق من الترحيل

  • تعرف على واجهات برمجة التطبيقات لـ Azure Resource Manager REST.
  • حدد واجهات برمجة تطبيقات تقارير المؤسسة التي تستخدمها وشاهد واجهات برمجة التطبيقات لإدارة التكاليف للانتقال إليها عند الترحيل من Azure Enterprise Reporting إلى واجهات برمجة تطبيقات Microsoft Cost Management.
  • قم بتكوين ترخيص الخدمة والمصادقة لواجهات برمجة تطبيقات إدارة التكلفة. لمزيد من المعلومات، راجع تعيين إذن لواجهات برمجة تطبيقات ACM.
  • اختبر واجهات برمجة التطبيقات ثم حدّث أي رمز برمجة لاستبدال استدعاءات API Reporting Enterprise باستدعاءات واجهة برمجة تطبيقات إدارة التكلفة.
  • قم بتحديث معالجة الأخطاء لاستخدام رموز الخطأ الجديدة. وتشمل بعض الاعتبارات ما يلي:
    • تتميز واجهات برمجة تطبيقات إدارة التكلفة بفترة مهلة تبلغ 60 ثانية.
    • واجهات برمجة تطبيقات إدارة التكلفة لديها قيود على المعدل في مكانها الصحيح. ينتج عن هذا 429 throttling error إذا تم تجاوز المعدلات. قم ببناء الحلول الخاصة بك بحيث لا تقوم بإجراء الكثير من استدعاءات واجهة برمجة التطبيقات في فترة زمنية قصيرة.
  • راجع واجهات برمجة تطبيقات إدارة التكلفة الأخرى المتوفرة من خلال Azure Resource Manager وقم بتقييمها للاستخدام لاحقاً. لمزيد من المعلومات، راجع الترحيل من Azure Enterprise Reporting إلى واجهات برمجة تطبيقات Microsoft Cost Management.

تعيين واجهة برمجة التطبيقات لإعداد التقارير الخاصة بالمؤسسات إلى واجهات برمجة تطبيقات إدارة التكلفة الجديدة

استخدم المعلومات التالية لتحديد واجهات برمجة التطبيقات لإعداد التقارير للمؤسسات التي تستخدمها حاليًا وواجهة برمجة تطبيقات إدارة التكلفة البديلة لاستخدامها بدلاً من ذلك.

السيناريو واجهات برمجة تطبيقات تقارير المؤسسة واجهات برمجة تطبيقات الإدارة من حيث التكلفة
الترحيل من واجهات برمجة التطبيقات لتفاصيل استخدام EA /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate
استخدم Microsoft.CostManagement/Exports لجميع أحمال عمل استيعاب البيانات المتكررة.
استخدم تقرير تفاصيل التكلفة لمجموعات البيانات الصغيرة عند الطلب.
الترحيل من واجهات برمجة تطبيقات ملخص رصيد EA /balancesummar استهلاك/ أرصدة Microsoft
الترحيل من واجهات برمجة تطبيقات ورقة أسعار EA /pricesheet بالنسبة إلى الأسعار المتفاوض عليها، استخدم Microsoft.Consumption/pricesheets/default
بالنسبة إلى أسعار التجزئة، استخدم واجهة برمجة تطبيقات أسعار التجزئة
الترحيل من واجهة برمجة تطبيقات تفاصيل استخدام المثيل المحجوز لـ EA /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
الترحيل من واجهة برمجة تطبيقات ملخص استخدام المثيل المحجوزة لـ EA /reservationsummaries Microsoft.Consumption/reservationSummaries
الترحيل من واجهات برمجة تطبيقات توصيات المثيل المحجوز لـ EA /SharedReservationRecommendations
/SingleReservationRecommendations
Microsoft.Consumption/reservationRecommendations
الترحيل من واجهات برمجة تطبيقات رسوم المثيل المحجوز لـ EA /reservationcharges Microsoft.Consumption/reservationTransactions

استخدام واجهات برمجة تطبيقات إدارة التكلفة الإضافية

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

  • الموازنات - تُستخدم لتعيين حملة الأسهم لمراقبة التكاليف بشكل استباقي وتنبيه حملة الأسهم المعنيين وأتمتة الإجراءات استجابةً لانتهاكات الحد الأدنى.
  • التنبيهات - تُستخدم لعرض معلومات التنبيه بما في ذلك، على سبيل المثال لا الحصر، تنبيهات الميزانية وتنبيهات الفواتير وتنبيهات الائتمان وتنبيهات الحصص.
  • عمليات التصدير - تُستخدم لجدولة تصدير البيانات المتكررة لرسومك إلى حساب تخزين Azure من اختيارك. إنه الحل الموصى به للعملاء الذين لديهم تواجد كبير في Azure والذين يرغبون في تحليل بياناتهم واستخدامها في أنظمتهم الداخلية.