Share via

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

  • مقالة

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

وجهات الترحيل

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

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

إشعار

يتوفر تقرير تفاصيل التكلفة فقط للعملاء الذين لديهم اتفاقية Enterprise أو اتفاقية عملاء Microsoft. إذا كان لديك اشتراك MSDN أو الدفع أولاً بأول أو Visual Studio، يمكنك الترحيل إلى عمليات التصدير أو الاستمرار في استخدام واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك.

ميزات الترحيل

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

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

اختلافات الحقول

يلخص الجدول التالي اختلافات الحقول بين واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك وواجهة برمجة تطبيقات Exports/Cost Details. توفر عمليات التصدير وواجهة برمجة تطبيقات تفاصيل التكلفة تنزيل ملف CSV بدلا من استجابة JSON المرقمة التي توفرها واجهة برمجة تطبيقات الاستهلاك.

تعيين حقل اتفاقية Enterprise

اتفاقية Enterprise العملاء الذين يستخدمون واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك لديهم سجلات تفاصيل الاستخدام من النوع legacy. يتم عرض سجل تفاصيل الاستخدام القديم أدناه. جميع العملاء اتفاقية Enterprise لديهم سجلات من هذا النوع بسبب نظام الفوترة الأساسي المستخدم لهم.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

يظهر مثال كامل على سجل تفاصيل الاستخدام القديم في تفاصيل الاستخدام - القائمة - واجهة برمجة تطبيقات REST (استهلاك Azure)

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

لم تتغير أسماء الخصائص الغامق.

Old Property New Property
accountName AccountName
معرف مالك الحساب معرف مالك الحساب
additionalInfo AdditionalInfo
AvailabilityZone AvailabilityZone
billingAccountId billingAccountId
billingAccountName BillingAccountName
billingCurrency BillingCurrencyCode
billingPeriodEndDate BillingPeriodEndDate
billingPeriodStartDate BillingPeriodStartDate
billingProfileId billingProfileId
billingProfileName BillingProfileName
chargeType ChargeType
consumedService ConsumedService
التكلفة CostInBillingCurrency
costCenter CostCenter
date التاريخ
EffectivePrice السعر الفعلي
معدل التكرار التكرار
invoiceSection InvoiceSectionName
معرف قسم الفواتير InvoiceSectionId
isAzureCreditEligible IsAzureCreditEligible
meterCategory MeterCategory
meterId معرف المتر
MeterName MeterName
منطقة العداد MeterRegion
meterSubCategory MeterSubCategory
offerID OfferId
partNumber PartNumber
PayGPrice PayGPrice
اسم الخطة PlanName
نموذج التسعير PricingModel
المنتج ProductName
ProductOrderId ProductOrderId
ProductOrderName ProductOrderName
اسم الناشر PublisherName
نوع الناشر PublisherType
الكمية الكمية
معرف الحجز ReservationId
اسم الحجز ReservationName
resourceGroup ResourceGroup
resourceId ResourceId
resourceLocation ResourceLocation
resourceName ResourceName
serviceFamily ServiceFamily
ServiceInfo1 ServiceInfo1
ServiceInfo2 ServiceInfo2
subscriptionId SubscriptionId.
اسم الاشتراك اسم الاشتراك
العلامات علامات
مصطلح الشرط
unitOfMeasure UnitOfMeasure
unitPrice UnitPrice
CostAllocationRuleName CostAllocationRuleName

الأسئلة المتداولة عن اتفاقية عملاء Microsoft

اتفاقية عملاء Microsoft العملاء الذين يستخدمون واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك لديهم سجلات تفاصيل الاستخدام من النوع modern. يظهر أدناه سجل تفاصيل الاستخدام الحديث. جميع العملاء اتفاقية عملاء Microsoft لديهم سجلات من هذا النوع بسبب نظام الفوترة الأساسي المستخدم لهم.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

يظهر مثال كامل على سجل تفاصيل الاستخدام القديم في تفاصيل الاستخدام - القائمة - واجهة برمجة تطبيقات REST (استهلاك Azure)

يتم عرض تعيين بين الحقلين القديم والجديد في الجدول التالي. تتوفر خصائص جديدة في ملفات CSV التي تنتجها عمليات التصدير وواجهة برمجة تطبيقات تفاصيل التكلفة. يتم عرض الحقول التي تحتاج إلى تعيين بسبب الاختلافات عبر الحلول في نص غامق.

لمزيد من المعلومات، راجع فهم حقول تفاصيل الاستخدام.

الخاصية القديمة الخاصية الجديدة
invoiceId invoiceId
previousInvoiceId previousInvoiceId
billingAccountId billingAccountId
billingAccountName billingAccountName
billingProfileId billingProfileId
billingProfileName billingProfileName
invoiceSectionId invoiceSectionId
invoiceSectionName invoiceSectionName
partnerTenantId partnerTenantId
partnerName partnerName
resellerName resellerName
resellerMpnId resellerMpnId
customerTenantId customerTenantId
customerName customerName
costCenter costCenter
billingPeriodEndDate billingPeriodEndDate
billingPeriodStartDate billingPeriodStartDate
servicePeriodEndDate servicePeriodEndDate
servicePeriodStartDate servicePeriodStartDate
date date
serviceFamily serviceFamily
productOrderId productOrderId
productOrderName productOrderName
consumedService consumedService
meterId meterId
MeterName MeterName
meterCategory meterCategory
meterSubCategory meterSubCategory
meterRegion meterRegion
productIdentifier ProductId
المنتج اسم المنتج
subscriptionGuid SubscriptionId.
اسم الاشتراك اسم الاشتراك
publisherType publisherType
publisherId publisherId
publisherName publisherName
resourceGroup resourceGroupName
instanceName ResourceId
resourceLocationNormalized موقع
resourceLocation موقع
EffectivePrice EffectivePrice
الكمية الكمية
unitOfMeasure unitOfMeasure
chargeType chargeType
billingCurrencyCode الفوترةCurrency
pricingCurrencyCode الأسعارالسعر
costInBillingCurrency costInBillingCurrency
costInPricingCurrency costInPricingCurrency
costInUsd costInUsd
paygCostInBillingCurrency paygCostInBillingCurrency
paygCostInUSD paygCostInUsd
exchangeRatePricingToBilling exchangeRatePricingToBilling
exchangeRateDate exchangeRateDate
isAzureCreditEligible isAzureCreditEligible
serviceInfo1 serviceInfo1
serviceInfo2 serviceInfo2
additionalInfo additionalInfo
العلامات العلامات
partnerEarnedCreditRate partnerEarnedCreditRate
partnerEarnedCreditApplied partnerEarnedCreditApplied
سعر السوق PayGPrice
معدل التكرار معدل التكرار
‏‏المصطلح ‏‏المصطلح
reservationId reservationId
reservationName reservationName
pricingModel pricingModel
unitPrice unitPrice
exchangeRatePricingToBilling exchangeRatePricingToBilling

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