Migrieren von der Verbrauchsnutzungsdetails-API
In diesem Artikel wird die Migration von der Verbrauchsnutzungsdetails-API erläutert, deren Unterstützung eingestellt werden soll. Das genaue Datum der Deaktivierung wird noch ermittelt. Es wird empfohlen, Ihre Pipelines zur Berichterstellung nicht mithilfe dieser API zu erstellen und so schnell wie möglich davon weg zu migrieren.
Die EA-Berichterstellungs-APIs (Enterprise Agreement), die einen API-Schlüssel für die Authentifizierung verwenden und über den URI-Endpunkt consumption.azure.com aufgerufen werden, werden eingestellt. EA-Kunden, die diese APIs verwenden, wird empfohlen, zur Cost Management-API Kostendetails zu migrieren. Diese älteren EA-Berichterstellungs-APIs sind nur für Kunden mit einem Enterprise Agreement verfügbar.
Wenn Sie die API Nutzungsdetails zum Verbrauch verwenden, empfehlen wir Ihnen die Migration zur API Cost Management Details zu Kosten, eine Migration ist jedoch nicht zwingend erforderlich.
Verbrauchs- und Cost Management-APIs sind sowohl für EA Microsoft-Kundenvereinbarung (MCA)-Kunden verfügbar. Azure Government-Kunden, die unter einem EA verbleiben, sind also nicht negativ betroffen.
Wenn Sie von EA zu MCA migrieren, empfiehlt es sich, von der EA API Berichterstellung Nutzungsdetails zur Kostenverwaltungskosten-API zu wechseln und Exporte zu verwenden.
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 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 Exporte oder die 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. Alle Kunden mit Enterprise Agreement haben Datensätze dieses Typs aufgrund des zugrunde liegenden Abrechnungssystems, das für sie verwendet wird. Hier sehen Sie einen älteren Beispieldatensatz für Nutzungsdetails:
{
"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. Alle Kunden mit Microsoft-Kundenvereinbarung haben Datensätze dieses Typs aufgrund des zugrunde liegenden Abrechnungssystems, das für sie verwendet wird. Hier ist ein Beispiel für einen MCA-Nutzungsdetails-Eintrag:
{
"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.