ترحيل من اتفاقية 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 |
| توصيات الحجز | /SharedReservation التوصيات /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 | بلا | |
| 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}/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}/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/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/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/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/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/28ae4b7f-41bb-581e-9fa4-8270c857aa5f/billingProfiles/ef37facb-cd6f-437a-9261-65df15b673f9/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.
الملاحظات
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجع https://aka.ms/ContentUserFeedback.
إرسال الملاحظات وعرضها المتعلقة بـ