Aracılığıyla paylaş

Tüketim Kullanımı Ayrıntıları API'sinden geçiş

  • Makale

Bu makalede, Tüketim Kullanımı Ayrıntıları API'sinden uzağa geçiş açıklanır. Tüketim Kullanımı Ayrıntıları API'si kullanım dışıdır. API'nin kapatılacağı tarih hala belirleniyor. API'den mümkün olan en kısa sürede geçiş yapmanızı öneririz.

Geçiş hedefleri

İş yükünüz için uygun çözümü seçmeden önce Maliyet ayrıntıları çözümü seçme makalesini okuyun. Genel olarak, devam eden veri alımı gereksinimleriniz ve büyük bir aylık kullanım ayrıntıları veri kümeniz varsa Dışarı Aktarmalar'ı öneririz. Daha fazla bilgi için bkz . Kullanım ayrıntıları verilerini alma.

Daha küçük bir kullanım ayrıntıları veri kümeniz veya Dışarı Aktarmalar tarafından karşılanmamış bir senaryonuz varsa bunun yerine Maliyet Ayrıntıları raporunu kullanmayı göz önünde bulundurun. Daha fazla bilgi için bkz . İsteğe bağlı olarak küçük maliyetli veri kümeleri alma.

Not

Maliyet Ayrıntıları raporu yalnızca Kurumsal Anlaşma veya Microsoft Müşteri Sözleşmesi olan müşteriler tarafından kullanılabilir. MSDN, kullandıkça öde veya Visual Studio aboneliğiniz varsa Dışarı Aktarmalar'a geçiş yapabilir veya Tüketim Kullanımı Ayrıntıları API'sini kullanmaya devam edebilirsiniz.

Geçiş avantajları

Yeni çözümler, Tüketim Kullanımı Ayrıntıları API'sine göre birçok avantaj sağlar. Özet aşağıdadır:

  • Tüm kullanım ayrıntıları için tek veri kümesi - Azure ve Azure Market kullanım ayrıntıları tek bir veri kümesinde birleştirildi. Tüm ücretlerinizi görmek için aramanız gereken API sayısını azaltır.
  • Ölçeklenebilirlik - Marketler API'si, Azure kullanımınız arttıkça ölçeklendirilemeyecek bir çağrı desenini yükselttiklerinden kullanım dışıdır. Buluta daha fazla kaynak dağıttıkça kullanım ayrıntıları veri kümesi son derece genişleyebilir. Marketler API'si sayfalandırılmış bir zaman uyumlu API olduğundan, yüksek verimlilik ve güvenilirlikle büyük hacimli verileri ağ üzerinden etkili bir şekilde aktarmak için iyileştirilmemiştir. Dışarı aktarmalar ve Maliyet Ayrıntıları API'si zaman uyumsuz. Ağ üzerinden doğrudan indirilebilen bir CSV dosyası sağlar.
  • API geliştirmeleri - Dışarı aktarmalar ve Maliyet Ayrıntıları API'Azure desteği devam eden çözümlerdir. Tüm yeni özellikler bunlarla tümleştiriliyor.
  • Şema tutarlılığı - Maliyet Ayrıntıları raporu ve Dışarı Aktarmalar , senaryonuza göre bir çözümden diğerine taşıyabileceğiniz eşleşen alanlara sahip dosyalar sağlar.
  • Maliyet Ayırma tümleştirmesi - dışarı aktarmaları veya Maliyet Ayrıntıları API'sini kullanan müşteriler Kurumsal Anlaşma ve Microsoft Müşteri Sözleşmesi, yapılandırdıkları maliyet ayırma kurallarına göre ücretleri görüntüleyebilir. Maliyet ayırma hakkında daha fazla bilgi için bkz . Maliyetleri ayırma.

Alan Farkları

Aşağıdaki tabloda, Tüketim Kullanımı Ayrıntıları API'si ile Dışarı Aktarmalar/Maliyet Ayrıntıları API'si arasındaki alan farkları özetlemektedir. Dışarı aktarmalar ve Maliyet Ayrıntıları API'si, Tüketim API'sinin sağladığı sayfalandırılmış JSON yanıtı yerine bir CSV dosyası indirmesi sağlar.

alan eşlemesini Kurumsal Anlaşma

Tüketim Kullanımı Ayrıntıları API'sini kullanan müşteriler Kurumsal Anlaşma türündeki legacykullanım ayrıntıları kayıtlarına sahiptir. Eski kullanım ayrıntıları kaydı aşağıda gösterilmiştir. Tüm Kurumsal Anlaşma müşterileri, kendileri için kullanılan temel faturalama sisteminden dolayı bu tür kayıtlara sahiptir.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

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

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

Kullanım Ayrıntıları - Liste - REST API (Azure Tüketimi) bölümünde tam örnek bir eski Kullanım Ayrıntıları kaydı gösterilir

Aşağıdaki tablo, eski ve yeni alanlar arasında bir eşleme sağlar. Yeni özellikler, Dışarı Aktarmalar ve Maliyet Ayrıntıları API'sinin ürettiği CSV dosyalarında kullanılabilir. Alanlar hakkında daha fazla bilgi edinmek için bkz . Kullanım ayrıntıları alanlarını anlama.

Kalın özellik adları değişmez.

Eski Özellik Yeni Özellik
accountName AccountName
AccountOwnerId AccountOwnerId
additionalInfo AdditionalInfo
AvailabilityZone AvailabilityZone
billingAccountId BillingAccountId
billingAccountName BillingAccountName
billingCurrency BillingCurrencyCode
billingPeriodEndDate BillingPeriodEndDate
billingPeriodStartDate BillingPeriodStartDate
billingProfileId BillingProfileId
billingProfileName BillingProfileName
chargeType ChargeType
consumedService ConsumedService
maliyet CostInBillingCurrency
costCenter CostCenter
tarih Tarih
effectivePrice EffectivePrice
frequency Sıklık
invoiceSection InvoiceSectionName
InvoiceSectionId InvoiceSectionId
isAzureCreditEligible IsAzureCreditEligible
meterCategory MeterCategory
meterId MeterId
meterName MeterName
MeterRegion MeterRegion
meterSubCategory MeterSubCategory
offerId OfferId
partNumber PartNumber
PayGPrice PayGPrice
PlanName PlanName
PricingModel PricingModel
ürün ProductName
ProductOrderId ProductOrderId
ProductOrderName ProductOrderName
Publishername PublisherName
Publishertype PublisherType
quantity Miktar
ReservationId ReservationId
ReservationName ReservationName
resourceGroup ResourceGroup
resourceId ResourceId
resourceLocation ResourceLocation
resourceName ResourceName
serviceFamily ServiceFamily
ServiceInfo1 ServiceInfo1
ServiceInfo2 ServiceInfo2
subscriptionId SubscriptionId
subscriptionName SubscriptionName
Etiketler Etiketler
Süre Süre
unitOfMeasure UnitOfMeasure
unitPrice UnitPrice
CostAllocationRuleName CostAllocationRuleName

alan eşlemesini Microsoft Müşteri Sözleşmesi

Tüketim Kullanımı Ayrıntıları API'sini kullanan müşteriler Microsoft Müşteri Sözleşmesi türündeki modernkullanım ayrıntıları kayıtlarına sahiptir. Modern kullanım ayrıntıları kaydı aşağıda gösterilmiştir. Tüm Microsoft Müşteri Sözleşmesi müşterileri için kullanılan temel faturalama sistemi nedeniyle bu tür kayıtlara sahiptir.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

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

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

Kullanım Ayrıntıları - Liste - REST API (Azure Tüketimi) bölümünde tam örnek bir eski Kullanım Ayrıntıları kaydı gösterilir

Aşağıdaki tabloda eski ve yeni alanlar arasında bir eşleme gösterilmektedir. Yeni özellikler, Dışarı Aktarmalar ve Maliyet Ayrıntıları API'sinin ürettiği CSV dosyalarında kullanılabilir. Çözümler arasındaki farklar nedeniyle eşleme gerektiren alanlar kalın metin olarak gösterilir.

Daha fazla bilgi için bkz . Kullanım ayrıntıları alanlarını anlama.

Eski özellik Yeni özellik
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
Müşteriadı Müşteriadı
costCenter costCenter
billingPeriodEndDate billingPeriodEndDate
billingPeriodStartDate billingPeriodStartDate
servicePeriodEndDate servicePeriodEndDate
servicePeriodStartDate servicePeriodStartDate
tarih tarih
serviceFamily serviceFamily
productOrderId productOrderId
productOrderName productOrderName
consumedService consumedService
meterId meterId
meterName meterName
meterCategory meterCategory
meterSubCategory meterSubCategory
meterRegion meterRegion
productIdentifier Productıd
Ürün Productname
subscriptionGuid SubscriptionId
subscriptionName subscriptionName
publisherType publisherType
publisherId publisherId
publisherName publisherName
resourceGroup resourceGroupName
Örnekadı ResourceId
resourceLocationNormalized konum
resourceLocation konum
effectivePrice effectivePrice
quantity quantity
unitOfMeasure unitOfMeasure
chargeType chargeType
billingCurrencyCode billingCurrency
pricingCurrencyCode pricingCurrency
costInBillingCurrency costInBillingCurrency
costInPricingCurrency costInPricingCurrency
costInUsd costInUsd
paygCostInBillingCurrency paygCostInBillingCurrency
paygCostInUSD paygCostInUsd
exchangeRatePricingToBilling exchangeRatePricingToBilling
exchangeRateDate exchangeRateDate
isAzureCreditEligible isAzureCreditEligible
serviceInfo1 serviceInfo1
serviceInfo2 serviceInfo2
additionalInfo additionalInfo
tags tags
partnerEarnedCreditRate partnerEarnedCreditRate
partnerEarnedCreditApplied partnerEarnedCreditApplied
marketFiyat PayGPrice
frequency frequency
terimi terimi
reservationId reservationId
reservationName reservationName
pricingModel pricingModel
unitPrice unitPrice
exchangeRatePricingToBilling exchangeRatePricingToBilling

İlgili içerik