الترحيل من واجهات برمجة تطبيقات تفاصيل استخدام EA
يحتاج عملاء EA الذين كانوا يستخدمون واجهات برمجة تطبيقات تقارير المؤسسة خلف نقطة النهاية consumption.azure.com للحصول على تفاصيل الاستخدام ورسوم السوق إلى الترحيل إلى حلول جديدة ومحسنة. يتم توضيح الإرشادات أدناه جنبا إلى جنب مع اختلافات العقد بين واجهة برمجة التطبيقات القديمة والحلول الجديدة.
يشار إلى مجموعة البيانات باسم تفاصيل التكلفة بدلاً من تفاصيل الاستخدام.
إشعار
تم إيقاف جميع واجهات برمجة تطبيقات تقارير Azure Enterprise. يجب الترحيل إلى واجهات برمجة تطبيقات Microsoft Cost Management في أقرب وقت ممكن.
حلول جديدة متاحة بشكل عام
يوفر الجدول التالي ملخصًا لوجهات الترحيل المتوفرة جنبًا إلى جنب مع ملخص لما يجب مراعاته عند اختيار الحل الأفضل بالنسبة لك.
| حل | الوصف | الاعتبارات | معلومات الإلحاق |
|---|---|---|---|
| التصديرات | تفريغ البيانات المتكررة إلى التخزين على جدول زمني | - الحل الأكثر قابلية للتطوير لأحمال العمل الخاصة بك. - يمكن تكوينه لاستخدام تقسيم الملفات لمجموعات البيانات الأكبر. - رائع لإنشاء مجموعة بيانات التكلفة التي يمكن دمجها مع مخازن البيانات القابلة للاستعلام الخاصة بك وتناميها. -يتطلب الوصول إلى حساب تخزين يمكنه الاحتفاظ بالبيانات. |
- تكوين في مدخل Microsoft Azure أتمتة إنشاء التصدير باستخدام واجهة برمجة التطبيقات - تصدير مرجع واجهة برمجة التطبيقات |
| تفاصيل التكلفة واجهة برمجة التطبيقات | تنزيل عند الطلب | - مفيد لمجموعات بيانات التكلفة الصغيرة. - مفيد للسيناريوهات التي لا تكون فيها عمليات التصدير إلى تخزين Azure ممكنة بسبب مخاوف تتعلق بالأمان أو الإدارة. |
- احصل على مجموعات بيانات صغيرة التكلفة عند الطلب - تفاصيل التكلفة واجهة برمجة التطبيقات |
بشكل عام، نوصي باستخدام عمليات التصدير إذا كانت لديك احتياجات مستمرة لاستيعاب البيانات و/أو مجموعة بيانات كبيرة لتفاصيل التكلفة الشهرية. لمزيد من المعلومات، راجع استيعاب بيانات تفاصيل التكلفة. إذا كنت بحاجة إلى معلومات إضافية لمساعدتك في اتخاذ قرار لحمل العمل، فشاهد اختيار حل تفاصيل التكلفة.
تعيين أذونات إلى SPN لاستدعاء واجهات برمجة التطبيقات
إذا كنت تبحث عن استدعاء واجهات برمجة التطبيقات عمليات التصدير أو تفاصيل التكلفة برمجيا، فأنت بحاجة إلى تكوين كيان الخدمة بالإذن الصحيح. لمزيد من المعلومات، راجع تعيين أذونات الوصول إلى واجهات ACM API.
تجنب واجهة برمجة تطبيقات تفاصيل استخدام استهلاك Microsoft
واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك هي نقطة نهاية أخرى تدعم حاليًا عملاء EA. لا تقم بالترحيل إلى واجهة برمجة التطبيقات هذه. ترحيل إما إلى Exports أو Cost Details API، كما هو موضح سابقًا في هذا المستند. سيتم إهمال واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك في المستقبل وتقع خلف نقطة النهاية التالية.
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01
واجهة برمجة التطبيقات هذه هي نقطة نهاية متزامنة ولن تتمكن من التوسع مع زيادة كل من إنفاقك وحجم الشهر على مجموعة بيانات تكلفة الشهر. إذا كنت تستخدم حاليًا واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك، نوصي بترحيلها إلى تصديرات واجهة برمجة تطبيقات تفاصيل التكلفة في أقرب وقت ممكن. وسيتم الإعلان رسميا عن الإهمال في تاريخ لاحق. لمعرفة المزيد حول الترحيل بعيدًا عن تفاصيل استخدام الاستهلاك، راجع الترحيل من واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك.
ميزات الترحيل
توفر حلولنا الجديدة العديد من الفوائد عبر واجهات برمجة تطبيقات تفاصيل استخدام تقارير EA. فيما يلي ملخص:
- الأمان والاستقرار - تتطلب الحلول الجديدة الرموز المميزة لمدير الخدمة و/أو المستخدم من أجل الوصول إلى البيانات. إنها أكثر أمانًا من مفاتيح واجهة برمجة التطبيقات المستخدمة للمصادقة على واجهات برمجة تطبيقات تقارير EA. المفاتيح في واجهات برمجة التطبيقات القديمة هذه صالحة لمدة ستة أشهر ويمكن أن تعرض البيانات المالية الحساسة إذا تم تسريبها. بالإضافة إلى ذلك، إذا لم يتم تجديد المفاتيح ودمجها في أحمال العمل قبل انتهاء صلاحيتها لمدة ستة أشهر، يتم إبطال الوصول إلى البيانات. هذا يقاطع أحمال عمل العملاء.
- قابلية التوسع - لم يتم إنشاء واجهات برمجة تطبيقات تقارير EA لتوسيع نطاقها بالإضافة إلى زيادة استخدام Azure. يمكن أن تصبح مجموعة بيانات تفاصيل الاستخدام كبيرة للغاية عند توزيع المزيد من الموارد في السحابة. الحلول الجديدة غير متزامنة وحوزة تحسينات واسعة في البنية التحتية خلفها لضمان التنزيلات الناجحة لأي مجموعة بيانات بحجم.
- مجموعة بيانات واحدة لجميع تفاصيل الاستخدام - تم دمج تفاصيل استخدام Azure وAzure Marketplace في مجموعة بيانات واحدة في الحلول الجديدة. تقلل مجموعة البيانات الفردية من عدد واجهات برمجة التطبيقات التي تحتاج إلى الاتصال بها لمشاهدة جميع الرسوم الخاصة بك.
- إطفاء الشراء - يمكن للعملاء الذين يشترون الحجوزات رؤية عرض مطفأ لتكاليفهم باستخدام الحلول الجديدة.
- تناسق المخطط - يوفر كل حل متوفر ملفات مع حقول مطابقة. يسمح لك بالتنقل بسهولة بين الحلول بناء على السيناريو الخاص بك.
- تكامل تخصيص التكلفة - يمكن للعملاء اتفاقية Enterprise اتفاقية عملاء Microsoft استخدام الحل الجديد لعرض الرسوم فيما يتعلق بقواعد تخصيص التكلفة التي قاموا بتكوينها. لمزيد من المعلومات حول تخصيص التكلفة، راجع تخصيص التكاليف.
- تحسينات المضي قدمًا - يتم تطوير الحلول الجديدة بنشاط للمضي قدمًا. تتلقى الحلول جميع الميزات الجديدة عند إصدارها.
واجهات برمجة تطبيقات استخدام المؤسسة للترحيل
يلخص الجدول التالي واجهات برمجة التطبيقات المختلفة التي قد تستخدمها اليوم لاستيعاب بيانات تفاصيل التكلفة. إذا كنت تستخدم أحد واجهات برمجة التطبيقات التالية، فستحتاج إلى الترحيل إلى أحد الحلول الجديدة الموضحة سابقا. جميع واجهات برمجة التطبيقات خلف https://consumption.azure.com نقطة النهاية.
| نقطة النهاية | تعليقات واجهة برمجة التطبيقات |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
- أسلوب واجهة برمجة التطبيقات: GET - متزامن (غير تحقق) - تنسيق البيانات: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
- أسلوب واجهة برمجة التطبيقات: GET - متزامن (غير تحقق) - تنسيق البيانات: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
- أسلوب واجهة برمجة التطبيقات: GET - متزامن (غير تحقق) - تنسيق البيانات: JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
- أسلوب واجهة برمجة التطبيقات: GET - متزامن (غير تحقق) - تنسيق البيانات: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
- أسلوب واجهة برمجة التطبيقات: GET - متزامن (غير تحقق) - تنسيق البيانات: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
- أسلوب واجهة برمجة التطبيقات: POST - غير متزامن (يستند إلى التحقق) - تنسيق البيانات: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
- أسلوب واجهة برمجة التطبيقات: POST - غير متزامن (يستند إلى التحقق) - تنسيق البيانات: CSV |
تعيين حقل البيانات
يوفر الجدول التالي ملخصا للحولات القديمة المتوفرة في الحلول التي تستخدمها حاليا مع الحقل الذي تريد استخدامه في الحلول الجديدة.
| الحقل القديم | حقل جديد | التعليقات |
|---|---|---|
| AccountId | غير متوفر - استخدم AccountName للحصول على معلومات الحساب. | |
| accountName | AccountName | |
| accountOwnerEmail | معرف مالك الحساب | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | الخصائص هي الأضداد. إذا كان isAzureCreditEnabled صحيحا، ChargesBilledSeparately سيكون خطأ. |
| consumedQuantity | الكمية | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId يوفر قيمة رقمية فقط.ConsumedService يوفر اسم الخدمة. |
| التكلفة | CostInBillingCurrency | |
| costCenter | CostCenter | |
| date | التاريخ | كان التنسيق في الحقل القديم هو yyyy-mm-dd، بينما يكون الحقل الجديد بالتنسيق mm/dd/yyyy. |
| departmentId | InvoiceSectionId | الحقل فارغ حاليا. استخدم DepartmentName للحصول على معلومات القسم. |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | عند الاقتضاء، استخدم Frequency و Term fields للمضي قدما. |
|
| موقع | موقع المورد غير متممم | ResourceLocationNormalized موجود في تقرير تفاصيل التكلفة، ولكن ليس بعد في الصادرات. |
| meterCategory | MeterCategory | |
| meterId | معرف المتر | |
| MeterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerID | OfferId | |
| orderNumber | غير متوفر. | |
| partNumber | PartNumber | |
| planName | PlanName | |
| المنتج | ProductName | |
| publisherName | PublisherName | |
| resourceGroup | ResourceGroup | |
| resourceGuid | معرف المتر | تختلف القيم. resourceGuid هي قيمة GUID. meterId هو رقم طويل. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | غير متوفر. | |
| resourceRate | السعر الفعلي | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | غير متوفر. | |
| subscriptionGuid | SubscriptionId. | |
| subscriptionId | SubscriptionId. | |
| اسم الاشتراك | اسم الاشتراك | |
| العلامات | علامات | لا يحتوي الحقل الجديد على إحاطة {} حول أزواج قيمة المفتاح. |
| unitOfMeasure | UnitOfMeasure |
المحتوى ذو الصلة
الملاحظات
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجع https://aka.ms/ContentUserFeedback.
إرسال الملاحظات وعرضها المتعلقة بـ