Migrieren von der Verbrauchsnutzungsdetails-API

In diesem Artikel wird die Migration von der Verbrauchsnutzungsdetails-API erläutert. Die Verbrauchsnutzungsdetails-API ist veraltet. Das Datum, an dem die API deaktiviert wird, wird noch bestimmt. Es wird empfohlen, so bald wie möglich von der API weg zu migrieren.

Migrationsziele

Bevor Sie die für Ihre Workload geeignete Lösung auswählen, sollten Sie den Artikel Auswählen einer Kostendetaillösung lesen. Im Allgemeinen wird die Verwendung der Export--API empfohlen, wenn Sie regelmäßig Daten erfassen müssen oder über ein großes monatliches Dataset mit Nutzungsdetails verfügen. Weitere Informationen finden Sie unter Erfassen von Daten zu Kostendetails.

Wenn Sie über ein kleineres Dataset mit Nutzungsdetail verfügen oder die Export-API für Ihr Szenario nicht geeignet ist, sollten Sie stattdessen den Bericht Kostendetails verwenden. Weitere Informationen finden Sie unter Bedarfsgesteuertes Abrufen kleiner Kostendatasets.

Hinweis

Der Bericht Kostendetails ist nur für Kunden mit Enterprise Agreement oder Microsoft-Kundenvereinbarung verfügbar. Wenn Sie über ein MSDN- oder Visual Studio-Abonnement oder über ein Abonnement verfügen, das nutzungsbasiert abgerechnet wird, können Sie zur Export-API migrieren oder weiterhin die Verbrauchsnutzungsdetails-API verwenden.

Vorteile der Migration

Neue Lösungen bieten viele Vorteile gegenüber der Verbrauchsnutzungsdetails-API. Hier finden Sie eine Zusammenfassung:

• Ein einzelnes Dataset für alle Nutzungsdetails: Azure- und Azure Marketplace-Nutzungsdetails wurden in einem Dataset zusammengeführt. Dies reduziert die Anzahl der APIs, die Sie aufrufen müssen, um alle Ihre Gebühren anzuzeigen.
• Skalierbarkeit: Die Marketplaces-API ist veraltet, da sie auf einem Aufrufmuster basiert, das nicht mit Ihrer steigenden Azure-Nutzung skalieren kann. Das Dataset mit Nutzungsdetails kann bei zunehmender Bereitstellung von Ressourcen in der Cloud überaus groß werden. Die Marketplaces-API ist eine paginierte synchrone API und daher nicht dafür optimiert, große Datenmengen über ein Netzwerk mit hoher Effizienz und Zuverlässigkeit effektiv zu übertragen. Die Export- und Kostendetails-API arbeiten asynchron. Sie bieten Ihnen eine CSV-Datei, die direkt über das Netzwerk heruntergeladen werden kann.
• API-Verbesserungen: Die Export- und Kostendetails-API sind die Lösungen, die Azure von nun an unterstützt. Alle neuen Features werden in diese Lösungen integriert.
• Schemakonsistenz: Der Bericht Kostendetails und die Export-API stellen Dateien mit übereinstimmenden Feldern bereit, sodass Sie basierend auf Ihrem Szenario von einer Lösung zur anderen migrieren können.
• Kostenzuordnungsintegration: Kunden mit einem Enterprise Agreement und einer Microsoft-Kundenvereinbarung, die die Export- oder Kostendetails-API verwenden, können Gebühren entsprechend der von ihnen konfigurierten Kostenzuordnungsregeln anzeigen. Weitere Informationen zur Kostenzuordnung finden Sie unter Zuordnen von Kosten.

Feldunterschiede

In der folgenden Tabelle werden die Feldunterschiede zwischen der Verbrauchsnutzungsdetails-API und der Export- bzw. Kostendetails-API zusammengefasst. Die Export- und Kostendetails-API bieten einen CSV-Dateidownload anstelle der paginierten JSON-Antwort, die von der Verbrauchs-API bereitgestellt wird.

Feldzuordnung für Enterprise Agreement

Kunden mit Enterprise Agreement, die die Verbrauchsnutzungsdetails-API verwenden, verfügen über Datensätze mit Nutzungsdetails des Typs legacy. Ein Legacydatensatz mit Nutzungsdetails wird nachstehend gezeigt. Alle Kunden mit Enterprise Agreement haben Datensätze dieses Typs aufgrund des zugrunde liegenden Abrechnungssystems, das für sie verwendet wird.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

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

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Ein vollständiges Beispiel eines Legacydatensatzes mit Verbrauchsnutzungsdetails wird unter Nutzungsdetails – Liste – REST-API (Azure-Nutzung) gezeigt.

Die folgende Tabelle zeigt die Zuordnung zwischen den alten und neuen Feldern. Neue Eigenschaften sind in den CSV-Dateien verfügbar, die von der Exporte- und Kostendetails-API erstellt werden. Weitere Informationen zu den Feldern finden Sie unter Grundlegendes zu Feldern mit Nutzungsdetails.

Eigenschaftsnamen in Fettformatierung bleiben unverändert.

Alte Eigenschaft	Neue Eigenschaft
.	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
cost	CostInBillingCurrency
costCenter	CostCenter
Datum	Datum
effectivePrice	EffectivePrice
frequency	Häufigkeit
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
product	ProductName
ProductOrderId	ProductOrderId
ProductOrderName	ProductOrderName
PublisherName	PublisherName
PublisherType	PublisherType
quantity	Quantity (Menge)
ReservationId	ReservationId
ReservationName	ReservationName
resourceGroup	ResourceGroup
resourceId	ResourceId
resourceLocation	ResourceLocation
resourceName	Ressourcenname
serviceFamily	ServiceFamily
ServiceInfo1	ServiceInfo1
ServiceInfo2	ServiceInfo2
subscriptionId	SubscriptionId
subscriptionName	SubscriptionName
Tags	`Tags`
Begriff	Begriff
unitOfMeasure	UnitOfMeasure
unitPrice	UnitPrice (Stückpreis)
CostAllocationRuleName	CostAllocationRuleName

Feldzuordnung für Microsoft-Kundenvereinbarung

Kunden mit Microsoft-Kundenvereinbarung, die die Verbrauchsnutzungsdetails-API verwenden, verfügen über Datensätze mit Nutzungsdetails des Typs modern. Ein moderner Datensatz mit Nutzungsdetails wird nachstehend gezeigt. Alle Kunden mit Microsoft-Kundenvereinbarung haben Datensätze dieses Typs aufgrund des zugrunde liegenden Abrechnungssystems, das für sie verwendet wird.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

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

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Ein vollständiges Beispiel eines Legacydatensatzes mit Verbrauchsnutzungsdetails wird unter Nutzungsdetails – Liste – REST-API (Azure-Nutzung) gezeigt.

Die folgende Tabelle zeigt die Zuordnung zwischen den alten und neuen Feldern. Neue Eigenschaften sind in den CSV-Dateien verfügbar, die von der Export- und Kostendetails-API erstellt werden. Felder, die aufgrund von Unterschieden zwischen den Lösungen eine Zuordnung erfordern, sind fett formatiert.

Weitere Informationen finden Sie unter Grundlegendes zu Feldern mit Nutzungsdetails.

Alte Eigenschaft	Neue Eigenschaft
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
product	ProductName
subscriptionGuid	SubscriptionId
subscriptionName	subscriptionName
publisherType	publisherType
publisherId	publisherId
publisherName	publisherName
Ressourcengruppe	resourceGroupName
INSTANCENAME	resourceId
resourceLocationNormalized	location
resourceLocation	location
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
marketPrice	PayGPrice
frequency	frequency
Begriff	Begriff
reservationId	reservationId
reservationName	reservationName
pricingModel	pricingModel
unitPrice	unitPrice
exchangeRatePricingToBilling	exchangeRatePricingToBilling

Zugehöriger Inhalt

• Weitere Informationen über Kostenverwaltung + Rechnungsautomatisierung finden Sie unter Übersicht Kostenverwaltungsautomatisierung.