ترحيل من اتفاقية Enterprise إلى واجهات برمجة التطبيقات لاتفاقية عملاء Microsoft

تساعدك هذه المقالة في فهم بنية البيانات وواجهة برمجة التطبيقات (API) والاختلافات الأخرى في تكامل النظام بين حسابات اتفاقية Enterprise وحسابات اتفاقية عملاء Microsoft (MCA). تدعم إدارة التكلفة واجهات برمجة التطبيقات لكلا نوعي الحسابات. راجع مقالة إعداد حساب الفواتير لـ اتفاقية عملاء Microsoft قبل المتابعة.

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

واجهات برمجة تطبيقات اتفاقية عملاء Microsoft والتكامل

تتيح لك واجهات برمجة تطبيقات اتفاقية عملاء Microsoft والتكامل الجديد ما يلي:

• احصل على توفر كامل لواجهة برمجة التطبيقات من خلال Azure API الأصلية.
• تكوين فواتير متعددة في حساب فوترة واحد.
• قم بالوصول إلى واجهة برمجة تطبيقات مُدمجة مع استخدام خدمة Azure واستخدام Marketplace من جهة خارجية ومشتريات Marketplace.
• عرض التكاليف عبر ملفات تعريف الفوترة (مثل التسجيلات) باستخدام إدارة التكلفة.
• قم بالوصول إلى واجهات برمجة التطبيقات الجديدة لعرض التكاليف، والحصول على إشعار عندما تتجاوز التكاليف الحدود المحددة مسبقاً، وتصدير البيانات الأولية تلقائياً.

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

تساعدك العناصر التالية على الانتقال إلى MCA APIs.

• تعرف على حساب فوترة اتفاقية عملاء Microsoft الجديد.
• حدد واجهات برمجة التطبيقات التي تستخدمها واطلع على واجهات برمجة التطبيقات التي تم استبدالها في القسم التالي.
• تعرف على واجهات برمجة التطبيقات لـ Azure Resource Manager REST.
• إذا لم تكن تستخدم واجهات برمجة تطبيقات Azure Resource Manager بالفعل، فسجل تطبيق العميل الخاص بك باستخدام معرف Microsoft Entra.
• امنح التطبيق الذي تم إنشاؤه أثناء تسجيل تطبيق Microsoft Entra حق الوصول للقراءة إلى حساب الفوترة باستخدام التحكم في الوصول (IAM).
• قم بتحديث أي تعليمة برمجية لاستخدام مصادقة Microsoft Entra.
• قم بتحديث أي تعليمة برمجية لاستبدال استدعاءات EA API باستدعاءات MCA API.
• قم بتحديث معالجة الأخطاء لاستخدام رموز الخطأ الجديدة.
• راجع عروض التكامل الأخرى مثل Power BI لاتخاذ إجراءات أخرى مطلوبة.

واجهات برمجة التطبيقات EA التي تم استبدالها بواجهات برمجة تطبيقات اتفاقية عملاء Microsoft

تستخدم واجهات برمجة تطبيقات EA مفتاح API للمصادقة والتخويل. تستخدم واجهات برمجة تطبيقات MCA مصادقة Microsoft Entra.

إشعار

تم إيقاف جميع واجهات برمجة تطبيقات تقارير Azure Enterprise. يجب الترحيل إلى واجهات برمجة تطبيقات Microsoft Cost Management في أقرب وقت ممكن.

الغرض	واجهات برمجة تطبيقات لاتفاقية Enterprise	واجهات برمجة تطبيقات لاتفاقية عملاء Microsoft
الرصيد والاعتمادات	/balancesummar	Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae
الاستخدام (JSON)	/usagedetails /usagedetailsbycustomdate	اختيار حل تفاصيل التكلفة
الاستخدام (CSV)	/usagedetails/download /usagedetails/submit	اختيار حل تفاصيل التكلفة
استخدام Marketplace (CSV)	/رسوم السوق /marketplacechargesbycustomdate	اختيار حل تفاصيل التكلفة
فترات الفوترة	/billingperiods	Microsoft.Billing/billingAccounts/billingProfiles/invoices
ورقة الأسعار	/pricesheet	Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json أو csv Microsoft.Billing/billingAccounts/.../billingProfiles/.../invoices/... /pricesheet/default/download format=json أو csv Microsoft.Billing/billingAccounts/.. /billingProfiles/.. /providers/Microsoft.Consumption/pricesheets/download
مشتريات الحجز	/reservationcharges	Microsoft.Billing/billingAccounts/billingProfiles/transactions
توصيات الحجز	/SharedReservationRecommendations /SingleReservationRecommendations	Microsoft.Consumption/reservationRecommendations
استخدام الحجز	/reservationdetails /reservationsummaries	Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries

¹ تتوفر خدمة Azure واستخدام موقع تسوق لجهة خارجية مع واجهة برمجة تطبيقات تفاصيل الاستخدام.

تتوفر واجهات برمجة التطبيقات التالية لحسابات فوترة اتفاقية عملاء Microsoft:

الغرض	واجهة برمجة التطبيقات لاتفاقية عملاء Microsoft
حسابات الفوترة²	Microsoft.Billing/billingAccounts
ملفات تعريف الفوترة²	Microsoft.Billing/billingAccounts/billingProfiles
أقسام الفاتورة	Microsoft.Billing/billingAccounts/invoiceSections
الفواتير	Microsoft.Billing/billingAccounts/billingProfiles/invoices
اشتراكات الفوترة	{النطاق}/billingSubscriptions

² تعرض واجهات برمجة التطبيقات قوائم بالعناصر، وهي النطاقات، حيث تعمل تجارب إدارة التكلفة في مدخل Microsoft Azure وواجهات برمجة التطبيقات. لمزيد من المعلومات حول نطاقات إدارة التكلفة، راجع فهم النطاقات والعمل بها.

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

الغرض	عرض قديم	عرض جديد
Power BI	حزمة محتوى وموصل Microsoft Consumption Insights	موصل Microsoft Azure Consumption Insights

واجهات برمجة التطبيقات للحصول على الرصيد والاعتمادات

تم استخدام "ملخص الحصول على الرصيد" لتزويدك بملخص شهري ل:

• الأرصدة
• المشتريات الجديدة
• رسوم خدمة Azure Marketplace
• التعديلات
• رسوم الخدمة الزائدة

يتم استبدال جميع واجهات برمجة التطبيقات للاستهلاك بواجهات برمجة تطبيقات Azure الأصلية التي تستخدم معرف Microsoft Entra للمصادقة والتخويل. لمزيد من المعلومات حول استدعاء واجهات برمجة التطبيقات Azure REST، راجع Getting started with REST.

يتم استبدال واجهة برمجة تطبيقات Get Balance Summary بواجهة برمجة تطبيقات Microsoft.Billing / billingAccounts / billingProfiles / availableBalance.

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

الأسلوب	طلب URI
GET	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview

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

احصل على توزيع يومي للتكاليف من استخدام خدمة Azure، واستخدام Marketplace من جهة خارجية، ومشتريات Marketplace الأخرى باستخدام واجهات برمجة التطبيقات التالية. تم دمج واجهات برمجة التطبيقات (API) المنفصلة التالية لخدمات Azure واستخدام Marketplace من جهة خارجية. يتم استبدال واجهات برمجة التطبيقات القديمة إما ب Exports أو Cost Details API. لاختيار الحل المناسب لك، راجع اختيار حل تفاصيل التكلفة. يوفر كلا الحلين نفس ملف تفاصيل التكلفة ولديهما مشتريات السوق في البيانات، والتي تم عرضها سابقا فقط في ملخص الرصيد حتى الآن.

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

النوع	تنسيق المعرف
حساب الفوترة	/Microsoft.Billing/billingAccounts/{billingAccountId}
ملف تعريف الفوترة	/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}
الاشتراك	/subscriptions/{subscriptionId}
مجموعة الموارد	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}

تم تغيير بعض أسماء الخصائص في مجموعة بيانات تفاصيل التكلفة الجديدة المتوفرة من خلال واجهة برمجة تطبيقات Exports and Cost Details. يوضح الجدول التالي الخصائص المقابلة.

الخاصية القديمة	خاصية جديدة	ملاحظات
AccountId	‏‫غير متوفر‬	لا يتم تعقب منشئ الاشتراك. استخدام invoiceSectionId (مثل departmentId).
AccountNameAccountOwnerId وAccountOwnerEmail	‏‫غير متوفر‬	لا يتم تعقب منشئ الاشتراك. استخدام invoiceSectionName (مثل departmentName).
AdditionalInfo	additionalInfo
ChargesBilledSeparately	isAzureCreditEligible	الخصائص هي الأضداد. إذا كان isAzureCreditEnabled صحيحاً، فإن ChargesBilledSeparately يكون خطأ.
ConsumedQuantity	الكمية
ConsumedService	consumedService	قد تختلف قيم السلسلة الدقيقة.
ConsumedServiceId	بلا
CostCenter	costCenter
التاريخ وusageStartDate	date
‏‏يوم	بلا	يوزع يوم من التاريخ.
DepartmentId	invoiceSectionId	تختلف القيم الدقيقة.
DepartmentName	invoiceSectionName	قد تختلف قيم السلسلة الدقيقة. قم بتكوين أقسام الفاتورة لمطابقة الأقسام، إذا لزم الأمر.
التكلفة الممتدة والتكلفة	costInBillingCurrency
معرف المثيل	resourceId
رسوم متكررة	بلا
الموقع	مكان
MeterCategory	meterCategory	قد تختلف قيم السلسلة الدقيقة.
معرف المتر	meterId	تختلف قيم السلسلة الدقيقة.
MeterName	MeterName	قد تختلف قيم السلسلة الدقيقة.
MeterRegion	meterRegion	قد تختلف قيم السلسلة الدقيقة.
MeterSubCategory	meterSubCategory	قد تختلف قيم السلسلة الدقيقة.
شهر	بلا	يوزع شهر من التاريخ.
اسم العرض	بلا	استخدام publisherName وproductOrderName.
OfferID	بلا
رقم الأمر	بلا
PartNumber	بلا	استخدم meterId وproductOrderName لتحديد الأسعار بشكل فريد.
اسم الخطة	productOrderName
المنتج	المنتج
ProductId	productId	تختلف قيم السلسلة الدقيقة.
اسم الناشر	publisherName
ResourceGroup	resourceGroupName
ResourceGuid	meterId	تختلف قيم السلسلة الدقيقة.
ResourceLocation	resourceLocation
ResourceLocationId	بلا
ResourceName	بلا
ResourceRate	EffectivePrice
ServiceAdministratorId	‏‫غير متوفر‬
ServiceInfo1	serviceInfo1
ServiceInfo2	serviceInfo2
ServiceName	meterCategory	قد تختلف قيم السلسلة الدقيقة.
ServiceTier	meterSubCategory	قد تختلف قيم السلسلة الدقيقة.
StoreServiceIdentifier	‏‫غير متوفر‬
SubscriptionGuid	subscriptionId
SubscriptionId.	subscriptionId
اسم الاشتراك	اسم الاشتراك
علامات	العلامات	تنطبق خاصية العلامات على الكائن الجذر، وليس على الخاصية المتداخلة للخصائص.
UnitOfMeasure	unitOfMeasure	تختلف قيم السلسلة الدقيقة.
usageEndDate	date
Year	بلا	يوزع سنة من التاريخ.
(جديد)	billingCurrency	العملة المستخدمة في الرسوم.
(جديد)	billingProfileId	معرّف فريد لملف تعريف الفوترة (مثل التسجيل).
(جديد)	billingProfileName	اسم ملف تعريف الفوترة (مثل التسجيل).
(جديد)	chargeType	استخدم للتمييز بين استخدام خدمة Azure واستخدام Marketplace وعمليات الشراء.
(جديد)	invoiceId	معرف الفريد للفاتورة. فارغ للشهر الحالي، المفتوح.
(جديد)	publisherType	نوع الناشر لعمليات الشراء. فارغة للاستخدام.
(جديد)	serviceFamily	نوع عملية الشراء. فارغة للاستخدام.
(جديد)	servicePeriodEndDate	تاريخ انتهاء الخدمة التي تم شراؤها.
(جديد)	servicePeriodStartDate	تاريخ بدء الخدمة التي تم شراؤها.

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

لا تستخدم حسابات فوترة اتفاقية عملاء Microsoft فترات الفوترة. وبدلاً من ذلك، يستخدمون الفواتير لتحديد نطاق التكاليف لفترات فوترة محددة. تم استبدال واجهة برمجة تطبيقات فترات الفوترة بواجهة برمجة تطبيقات الفواتير. يتم استبدال جميع واجهات برمجة التطبيقات للاستهلاك بواجهات برمجة تطبيقات Azure الأصلية التي تستخدم معرف Microsoft Entra للمصادقة والتخويل. لمزيد من المعلومات حول استدعاء واجهات برمجة التطبيقات Azure REST، راجع Getting started with REST.

للحصول على الفواتير باستخدام Invoices API:

الأسلوب	طلب URI
GET	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview

واجهة برمجة التطبيقات الخاصة بقائمة الأسعار

يناقش هذا القسم واجهات برمجة التطبيقات الموجودة في قائمة الأسعار ويقدم توصيات للانتقال إلى واجهة برمجة تطبيقات قائمة الأسعار لاتفاقيات عملاء Microsoft. كما تناقش API قائمة الأسعار لاتفاقيات عملاء Microsoft وتشرح الحقول في قوائم الأسعار. يتم استبدال واجهات برمجة التطبيقات الحصول على قائمة أسعار Enterprise والحصول على فترات فوترة Enterprise بواجهة برمجة تطبيقات ورقة الأسعار لاتفاقيات العملاء من Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). تدعم واجهة برمجة التطبيقات الجديدة كلاً من تنسيقات JSON وCSV، بتنسيقات REST غير المتزامنة. يتم استبدال جميع واجهات برمجة التطبيقات للاستهلاك بواجهات برمجة تطبيقات Azure الأصلية التي تستخدم معرف Microsoft Entra للمصادقة والتخويل. لمزيد من المعلومات حول استدعاء واجهات برمجة التطبيقات Azure REST، راجع Getting started with REST.

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

استخدمت واجهات برمجة التطبيقات للمؤسسات الفوترة مع تسجيلات المؤسسة للحصول على السعر ومعلومات فترة الفوترة. استخدمت المصادقة والتخويل رموز الويب المميزة ل Microsoft Entra.

للحصول على الأسعار المطبقة لتسجيل المؤسسة المحدد مع قائمة الأسعار وواجهات برمجة التطبيقات لفترة الفوترة:

الأسلوب	طلب URI
GET	https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet
GET	https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet

واجهة برمجة تطبيقات قائمة السعر لاتفاقيات عملاء Microsoft

استخدم واجهة برمجة تطبيقات قائمة الأسعار لاتفاقيات عملاء Microsoft لعرض الأسعار لجميع خدمات استهلاك Azure واستهلاك السوق. تنطبق الأسعار المعروضة لملف تعريف الفوترة على جميع الاشتراكات التي تنتمي إلى ملف تعريف الفوترة.

استخدم واجهة برمجة تطبيقات قائمة الأسعار لعرض جميع بيانات قائمة أسعار خدمات استهلاك Azure بتنسيق CSV:

الأسلوب	طلب URI
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv

استخدم واجهة برمجة تطبيقات قائمة الأسعار لعرض جميع بيانات قائمة أسعار خدمات استهلاك Azure بتنسيق JSON:

الأسلوب	طلب URI
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json

يؤدي استخدام واجهة برمجة التطبيقات إلى إرجاع قائمة الأسعار للحساب بأكمله. ومع ذلك، يمكنك أيضاً الحصول على نسخة مكثفة من قائمة الأسعار بتنسيق PDF. يتضمن الملخص خدمات استهلاك Azure واستهلاك Marketplace التي يتم تحرير فواتير بها لفاتورة معينة. يتم تعريف الفاتورة بواسطة {invoiceId}، وهو نفس رقم الفاتورة الموضح في ملفات PDF ملخص الفاتورة. وفيما يلي مثال على ذلك.

لعرض معلومات الفاتورة باستخدام واجهة برمجة تطبيقات Price Sheet بتنسيق CSV:

الأسلوب	طلب URI
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv

لعرض معلومات الفاتورة باستخدام واجهة برمجة تطبيقات Price Sheet بتنسيق JSON:

الأسلوب	طلب URI
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json

يمكنك أيضاً مشاهدة الأسعار المقدرة لأي خدمة استهلاك Azure أو خدمة استهلاك Marketplace في دورة الفوترة المفتوحة الحالية أو فترة الخدمة.

لعرض الأسعار المقدرة لخدمات الاستهلاك باستخدام واجهة برمجة التطبيقات Price Sheet بتنسيق CSV:

الأسلوب	طلب URI
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv

لعرض الأسعار المقدرة لخدمات الاستهلاك باستخدام واجهة برمجة التطبيقات Price Sheet بتنسيق JSON:

الأسلوب	طلب URI
POST	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json

واجهات برمجة التطبيقات قائمة الأسعار لاتفاقية عملاء Microsoft هي واجهات برمجة التطبيقات REST غير المتزامنة. تغيرت الاستجابات لواجهات برمجة التطبيقات من واجهات برمجة التطبيقات المتزامنة الأقدم. تم تغيير النص الأساسي لاستجابة واجهة برمجة التطبيقات أيضاً.

النص الأساسي للرد القديم

وفيما يلي مثال على استجابة واجهة برمجة تطبيقات REST المتزامنة:

[
        {
            "id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
            "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
            "meterName": "A1 VM",
            "unitOfMeasure": "100 Hours",
            "includedQuantity": 0,
            "partNumber": "N7H-00015",
            "unitPrice": 0.00,
            "currencyCode": "USD"
        },
        {
    ]

النص الأساسي للرد الجديد

تدعم واجهات برمجة التطبيقات تنسيق Azure REST غير المتزامن. استدعاء واجهة برمجة التطبيقات باستخدام GET وتلقي الاستجابة التالية:

No Response Body

HTTP Status 202 Accepted

يتم إرسال العناوين التالية مع موقع الإخراج:

Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Retry-After: 10

OData-EntityId: {operationId}

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

HTTP Status 200

{
  "id": "providers/Microsoft.Consumption/operationresults/{operationId}",
  "name": {operationId},
  "type": “Microsoft.Consumption/operationResults",
  "properties" : {
    "downloadUrl": {urltoblob},
    "validTill": "Date"
  }
}

يمكن للعميل أيضاً إجراء مكالمة GET لـ Azure-AsyncOperation. ترجع نقطة النهاية حالة العملية.

يعرض الجدول التالي الحقول في واجهة برمجة التطبيقات القديمة "للحصول على قائمة أسعار المؤسسة". وهو يتضمن الحقول المقابلة في قائمة الأسعار الجديدة لاتفاقيات عملاء Microsoft:

الخاصية القديمة	خاصية جديدة	ملاحظات
billingPeriodId	غير قابل للتطبيق	غير قابل للتطبيق. بالنسبة لاتفاقيات عملاء Microsoft، حلت الفاتورة وقائمة الأسعار المقترنة محل مفهوم billingPeriodId.
meterId	meterId
unitOfMeasure	unitOfMeasure	قد تختلف قيم السلسلة الدقيقة.
includedQuantity	includedQuantity	لا ينطبق على الخدمات الواردة في اتفاقيات عملاء Microsoft.
partNumber	غير قابل للتطبيق	بدلاً من ذلك، استخدم تركيبة من productOrderName (مثل offerID) وmeterID.
unitPrice	unitPrice	ينطبق سعر الوحدة على الخدمات المستهلكة في اتفاقيات عملاء Microsoft.
currencyCode	pricingCurrency	تحتوي اتفاقيات عملاء Microsoft على عروض أسعار بعملة التسعير والعملة الفوترة. يتوافق رمز العملة مع تسعير العملة في اتفاقيات عملاء Microsoft.
offerID	productOrderName	بدلاً من OfferID، يمكنك استخدام productOrderName ولكن ليس هو نفسه OfferID. ومع ذلك، فإن productOrderName والعداد يحددان الأسعار في اتفاقيات العملاء في Microsoft المتعلقة بـ meterId وOfferID في عمليات التسجيل القديمة.

عمليات واجهة برمجة تطبيقات قائمة أسعار الاستهلاك

بالنسبة لاتفاقيات المؤسسة، لقد استخدمت عمليتي واجهة برمجة تطبيقات صحيفة أسعار الاستهلاك Get وGet By Billing Period لنطاق عن طريق رقم الاشتراك أو فترة الفوترة. يستخدم واجهة برمجة التطبيقات لمصادقة إدارة موارد Azure.

للحصول على معلومات "Price Sheet" لنطاق باستخدام واجهة برمجة تطبيقات Price Sheet:

الأسلوب	طلب URI
GET	https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01

للحصول على معلومات Price Sheet حسب فترة الفوترة باستخدام واجهة برمجة تطبيقات Price Sheet:

الأسلوب	طلب URI
GET	https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01

بدلاً من نقاط النهاية API أعلاه، استخدم النقاط التالية لاتفاقيات عملاء Microsoft:

واجهة برمجة تطبيقات ورقة السعر لاتفاقيات عملاء Microsoft (واجهة برمجة تطبيقات REST غير المتزامنة)

واجهة برمجة التطبيقات هذه مخصصة اتفاقية عملاء Microsoft وتوفر سمات إضافية.

ورقة الأسعار لنطاق ملف تعريف الفوترة في حساب الفوترة

واجهة برمجة التطبيقات هذه هي واجهة برمجة التطبيقات الحالية. تم تحديثها لتوفير قائمة الأسعار لملف تعريف الفوترة في حساب فوترة.

قائمة الأسعار لنطاق حسب حساب الفوترة

يتم استخدام مصادقة Azure Resource Manager عند الحصول على "Price Sheet" في نطاق التسجيل في حساب الفوترة.

للحصول على Price Sheet في حساب التسجيل في حساب فوترة:

الأسلوب	طلب URI
GET	/providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01

للحصول على اتفاقية عملاء Microsoft، استخدم المعلومات الواردة في القسم التالي. يوفر خصائص الحقل المستخدمة في اتفاقيات عملاء Microsoft.

قائمة الأسعار لنطاق ملف تعريف الفوترة في حساب الفوترة

قائمة الأسعار المحدثة عن طريق واجهة برمجة تطبيقات حساب الفوترة يحصل على Price Sheet في شكل CSV. للحصول على Price Sheet في نطاق ملف تعريف الفوترة لاتفاقية عملاء Microsoft:

الأسلوب	طلب URI
GET	/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01

في نطاق التسجيل EA، تكون استجابة API والخصائص متطابقة. تتوافق الخصائص مع نفس خصائص اتفاقية عملاء Microsoft.

الخصائص القديمة لـ Azure Resource Manager Price Sheet APIs ونفس الخصائص الجديدة في الجدول التالي.

الخصائص القديمة لواجهة برمجة تطبيقات قائمة أسعار Azure Resource Manager	خاصية واجهة برمجة تطبيقات قائمة أسعار اتفاقية عملاء Microsoft الجديدة	‏‏الوصف
معرف العداد	meterId	المعرف الفريد للمقياس. نفس meterID.
اسم العداد	MeterName	اسم المقياس. يمثل العداد المورد القابل للنشر لخدمة Azure.
فئة القياس	service	اسم فئة التصنيف المقياس. نفس الخدمة الواردة في صحيفة أسعار اتفاقية عملاء Microsoft. تختلف قيم السلسلة الدقيقة.
فئة Meter الفرعية	meterSubCategory	اسم فئة التصنيف الفرعي للعداد. استناداً إلى تصنيف تمايز مجموعة الميزات عالية المستوى في الخدمة. على سبيل المثال، SQL DB الأساسية مقابل SQL DB القياسية.
منطقة العداد	meterRegion
الوحدة	غير قابل للتطبيق	يمكن توزيعها من unitOfMeasure.
وحدة القياس	unitOfMeasure
رقم الجزء	غير قابل للتطبيق	بدلاً من رقم الجزء، استخدم productOrderName وMeterID لتحديد سعر ملف تعريف الفوترة بشكل فريد. يتم سرد الحقول في فاتورة اتفاقية عملاء Microsoft بدلاً من رقم الجزء في فواتير اتفاقية عملاء Microsoft.
سعر الوحدة	unitPrice	سعر الوحدة في اتفاقية عملاء Microsoft.
‏كود العملة	pricingCurrency	تحتوي اتفاقيات عملاء Microsoft على عروض أسعار بعملة التسعير وعملة الفوترة. التعليمة البرمجية للعملة هي نفس pricingCurrency في اتفاقيات عملاء Microsoft.
الكمية المضمنة	includedQuantity	لا يسري على الخدمات الواردة في اتفاقيات عملاء Microsoft. تظهر قيم صفر.
معرّف العرض	productOrderName	بدلاً من OfferID، استخدم productOrderName. ليس نفس OfferID، ولكن productOrderName ومقياس تحديد التسعير في اتفاقيات عملاء Microsoft. تتعلق meterId وOfferID بعمليات التسجيل القديمة.

يتم تحديد سعر اتفاقيات عملاء Microsoft بشكل مختلف عن اتفاقيات المؤسسة. سعر الخدمات في تسجيل المؤسسات فريد للمنتج ورقم الجزء والعداد والعرض. لا يتم استخدام رقم الجزء في اتفاقيات عملاء Microsoft.

يعتبر سعر خدمة استهلاك Azure الذي يعد جزءاً من اتفاقية عملاء Microsoft فريداً لكل من productOrderName وmeterID. وتمثل عداد الخدمة وخطة المنتج.

للتوفيق بين قائمة الأسعار والاستخدام في API تفاصيل الاستخدام، يمكنك استخدام productOrderName وmeterID.

يمكن للمستخدمين الذين لديهم حقوق مالك ملف تعريف الفوترة والمساهم والقارئ ومدير الفاتورة تنزيل قائمة الأسعار.

تتضمن قائمة الأسعار أسعار الخدمات التي يعتمد سعرها على الاستخدام. وتشمل الخدمات استهلاك Azure واستهلاك Marketplace. يتم قفل أحدث سعر في نهاية كل فترة خدمة ويتم تطبيقه على الاستخدام في فترة خدمة مرة واحدة. بالنسبة لخدمات استهلاك Azure، تكون فترة الخدمة عادةً شهراً تقويمياً.

حقول واجهة برمجة التطبيقات لقائمة الأسعار الموقوفة

الحقول التالية إما غير متوفرة في واجهات برمجة تطبيقات قائمة أسعار اتفاقية عملاء Microsoft أو تحتوي على نفس الحقول.

الحقل الموقوف	‏‏الوصف
billingPeriodId	غير قابل للتطبيق. يتوافق مع InvoiceId لاتفاقية عملاء Microsoft.
offerID	غير قابل للتطبيق. يتوافق مع productOrderName في اتفاقية عملاء Microsoft.
meterCategory	غير قابل للتطبيق. يتوافق مع الخدمة في اتفاقية عملاء Microsoft.
الوحدة	غير قابل للتطبيق. يمكن توزيعها من unitOfMeasure.
currencyCode	نفس pricingCurrency في اتفاقية عملاء Microsoft.
meterLocation	نفس meterRegion في اتفاقية عملاء Microsoft.
partNumber	لا ينطبق ذلك لأن رقم الجزء غير مدرج في فواتير اتفاقية عملاء Microsoft. بدلاً من رقم الجزء، استخدم تركيبة meterId وproductOrderName لتحديد الأسعار بشكل فريد.
totalIncludedQuantity	غير قابل للتطبيق.
pretaxStandardRate	غير قابل للتطبيق.

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

يمكنك الحصول على حركات الفوترة لمشتريات الحجز باستخدام واجهة برمجة تطبيقات رسوم المثيل المحجوز. تتضمن واجهة برمجة التطبيقات الجديدة جميع عمليات الشراء، بما في ذلك عروض Marketplace التابعة لجهات خارجية. يتم استبدال جميع واجهات برمجة التطبيقات للاستهلاك بواجهات برمجة تطبيقات Azure الأصلية التي تستخدم معرف Microsoft Entra للمصادقة والتخويل. لمزيد من المعلومات حول استدعاء واجهات برمجة التطبيقات Azure REST، راجع Getting started with REST. يتم استبدال واجهة برمجة تطبيقات رسوم المثيل المحجوزة بواجهة برمجة تطبيقات العمليات.

للحصول على عمليات شراء الحجز باستخدام واجهة برمجة تطبيقات العمليات:

الأسلوب	طلب URI
GET	https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview

توصيات واجهات برمجة التطبيقات التي تم استبدالها

توفر واجهات برمجة التطبيقات المحجوزة لشراء المثيلات توصيات استخدام الجهاز الظاهري خلال آخر 7 أو 30 أو 60 يوماً. كما توفر واجهات برمجة التطبيقات توصيات شراء الحجز. يشمل ذلك ما يلي:

• واجهة برمجة التطبيقات لتوصية المثيل المحجوز المشترك
• واجهة برمجة التطبيقات لتوصية المثيل المحجوز الأحادي

يتم استبدال جميع واجهات برمجة التطبيقات للاستهلاك بواجهات برمجة تطبيقات Azure الأصلية التي تستخدم معرف Microsoft Entra للمصادقة والتخويل. لمزيد من المعلومات حول استدعاء واجهات برمجة التطبيقات Azure REST، راجع Getting started with REST. يتم استبدال واجهات برمجة التطبيقات لتوصيات الحجز المدرجة سابقاً بواجهة برمجة تطبيقات Microsoft.Consumption/reservationRecommendations.

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

الأسلوب	طلب URI
GET	https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01

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

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

يشمل ذلك ما يلي:

• تفاصيل استخدام المثيل المحجوز
• ملخص استخدام المثيل المحجوز

يتم استبدال جميع واجهات برمجة التطبيقات للاستهلاك بواجهات برمجة تطبيقات Azure الأصلية التي تستخدم معرف Microsoft Entra للمصادقة والتخويل. لمزيد من المعلومات حول استدعاء واجهات برمجة التطبيقات Azure REST، راجع Getting started with REST. يتم استبدال واجهات برمجة التطبيقات لتوصيات الحجز المدرجة سابقاً بواجهات برمجة تطبيقات Microsoft.Consumption/reservationDetails وMicrosoft.Consumption/reservationSummaries.

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

الأسلوب	طلب URI
GET	https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01

للحصول على ملخصات الحجز باستخدام واجهة برمجة تطبيقات ملخصات الحجز:

الأسلوب	طلب URI
GET	https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01

تكامل Power BI

يمكنك أيضاً استخدام Power BI في إعداد تقارير التكلفة. يمكن استخدام موصل Cost Management لـ Power BI Desktop لإنشاء تقارير قوية ومخصصة تساعدك على فهم إنفاقك على Azure بشكل أفضل. يدعم موصل إدارة التكلفة حالياً العملاء مع "اتفاقية عملاء Microsoft" أو اتفاقية Enterprise (EA).

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

• اقرأ وثائق Cost Management لمعرفة كيفية مراقبة الإنفاق على Azure والتحكم فيه. أو، إذا كنت ترغب في تحسين استخدام الموارد باستخدام Cost Management.