Teilen über


Migrieren von den EA-Nutzungsdetails-APIs

EA-Kunden, die bisher die Berichterstellungs-APIs für Azure Enterprise hinter dem Endpunkt consumption.azure.com verwendet haben, um Nutzungsdetails und Marketplace-Gebühren abzurufen, müssen zu neuen und verbesserten Lösungen migrieren. Die Anweisungen sowie die Vertragsunterschiede zwischen der alten API und den neuen Lösungen werden im Folgenden beschrieben.

Das Dataset wird nicht mehr Nutzungsdetails, sondern Kostendetails genannt.

Hinweis

Alle Azure Enterprise-Berichterstellungs-APIs werden eingestellt. Sie sollten so bald wie möglich zu Microsoft Cost Management-APIs migrieren.

Neue Lösungen sind allgemein verfügbar

In der folgenden Tabelle finden Sie eine Zusammenfassung der verfügbaren Migrationsziele sowie eine Übersicht der Faktoren, die Sie bei der Auswahl der für Sie am besten geeigneten Lösung berücksichtigen sollten.

Lösung BESCHREIBUNG Überlegungen Informationen zum Onboarding
Exports Regelmäßige Datensicherungen im Speicher nach einem Zeitplan – Ist die am einfachsten skalierbare Lösung für Ihre Workloads
– Kann so konfiguriert werden, dass für größere Datasets die Dateipartitionierung verwendet wird
– Ideal zum Einrichten und Vergrößern eines Kostendatasets, das mit Ihren eigenen abfragbaren Datenspeichern integriert werden kann
– Erfordert Zugriff auf ein Speicherkonto, in dem die Daten gespeichert werden können
- Konfigurieren im Azure-Portal
Automatisieren der Exporterstellung mit der API
- Referenz zur Export-API
Kostendetails-API Bedarfsabhängiges Herunterladen – Nützlich für kleine Kostendatasets
– Nützlich für Szenarios, in denen Exporte in Azure Storage aufgrund von Sicherheits- oder Verwaltbarkeitsproblemen nicht möglich sind
- Abrufen kleiner Kostendatasets bei Bedarf
- Kostendetails-API

Im Allgemeinen wird die Verwendung der Exporte-API empfohlen, wenn Sie regelmäßig Daten erfassen müssen oder über ein großes monatliches Kostendetailsdataset verfügen. Weitere Informationen finden Sie unter Erfassen von Daten zu Kostendetails. Wenn Sie zusätzliche Informationen benötigen, um eine Entscheidung bezüglich Ihrer Workload zu treffen, lesen Sie Auswählen einer Lösung für Kostendetails.

Zuweisen von Berechtigungen zu einem SPN zum Aufrufen der APIs

Wenn Sie entweder die Exporte- oder Kostendetails-APIs programmgesteuert aufrufen möchten, müssen Sie einen Dienstprinzipal mit der richtigen Berechtigung konfigurieren. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zu ACM-APIs.

Vermeiden der Microsoft Consumption Usage Details-API

Die Consumption Usage Details-API ist ein weiterer Endpunkt, der derzeit EA-Kunden unterstützt. Migrieren Sie nicht zu dieser API. Migrieren Sie entweder zur Exports- oder Kostendetails-API (wie zuvor in diesem Dokument beschrieben). Die Consumption Usage Details-API wird in Zukunft ausgemustert und befindet sich hinter dem folgenden Endpunkt.

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01

Diese API ist ein synchroner Endpunkt und kann nicht skaliert werden, wenn sowohl Ihre Ausgaben als auch die Größe Ihres monatlichen Kostendatasets zunehmen. Wenn Sie derzeit die Consumption Usage Details-API verwenden, wird empfohlen, dass Sie so bald wie möglich entweder zur Exporte-API oder der Kostendetails-API migrieren. Zu einem späteren Zeitpunkt wird eine offizielle Ankündigung zur Verkündigung erfolgen. Weitere Informationen zur Migration von der Consumption Usage Details-API finden Sie unter Migrieren von der Consumption Usage Details-API.

Vorteile der Migration

Unsere neuen Lösungen bieten viele Vorteile gegenüber den EA-Nutzungsdetails-APIs für die Berichterstellung. Hier finden Sie eine Zusammenfassung:

  • Sicherheit und Stabilität: Neue Lösungen erfordern einen Dienstprinzipal und bzw. oder ein Benutzertoken, um auf Daten zuzugreifen. Sie sind sicherer als die API-Schlüssel, die für die Authentifizierung bei den EA-Berichterstellungs-APIs verwendet werden. In diesen Legacy-APIs sind Schlüssel sechs Monate lang gültig und können vertrauliche Finanzdaten offenlegen, wenn diese an die Öffentlichkeit gelangen. Außerdem wird der Datenzugriff gesperrt, wenn die Schlüssel nicht vor Ablauf der sechs Monate erneuert und in die Workloads integriert werden. Dadurch werden Kundenworkloads beeinträchtigt.
  • Skalierbarkeit: Die EA-Berichterstellungs-APIs lassen sich nicht gut skalieren, wenn Ihre Azure-Nutzung zunimmt. Das Nutzungsdetailsdataset kann bei zunehmender Bereitstellung von Ressourcen in der Cloud sehr groß werden. Die neuen Lösungen sind asynchron und weisen umfangreiche Infrastrukturverbesserungen auf, um erfolgreiche Downloads für Datasets beliebiger Größe zu gewährleisten.
  • Einzelnes Dataset für alle Nutzungsdetails: Die Azure- und Azure Marketplace-Nutzungsdetails wurden in einem Dataset zusammengeführt. Durch die Verwendung eines einzelnen Datasets wird die Anzahl der APIs reduziert, die Sie aufrufen müssen, um alle Gebühren anzuzeigen.
  • Amortisation beim Kauf: Kunden, die Reservierungen kaufen, können mithilfe der neuen Lösungen eine amortisierte Ansicht ihrer Kosten anzeigen.
  • Schemakonsistenz: Jede verfügbare Lösung bietet Dateien mit übereinstimmenden Feldern. Dadurch können Sie je nach Szenario problemlos zwischen verschiedenen Lösungen wechseln.
  • Kostenzuordnungsintegration: Kunden mit einem Enterprise Agreement und einer Microsoft-Kundenvereinbarung können die neue Lösung verwenden, um Gebühren entsprechend der von ihnen konfigurierten Kostenzuordnungsregeln anzuzeigen. Weitere Informationen zur Kostenzuweisung finden Sie unter Zuweisen von Kosten.
  • Zukunftsweisende Verbesserungen: Die neuen Lösungen werden aktiv weiterentwickelt. Die Lösungen erhalten alle neuen Features, sobald diese veröffentlicht werden.

Nutzungs-APIs für Azure Enterprise, die eine Migration erfordern

In der folgenden Tabelle werden die verschiedenen APIs aufgeführt, mit denen Sie aktuell Kostendetails erfassen können. Wenn Sie eine der folgenden APIs verwenden, müssen Sie zu einer der zuvor beschriebenen neuen Lösungen migrieren. Alle APIs befinden sich hinter dem https://consumption.azure.com Endpunkt.

Endpunkt API-Kommentare
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} – API-Methode: GET
– Synchron (nicht abrufbasiert)
– Datenformat: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 – API-Methode: GET
– Synchron (nicht abrufbasiert)
– Datenformat: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails – API-Methode: GET
– Synchron (nicht abrufbasiert)
– Datenformat: JSON
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails – API-Methode: GET
– Synchron (nicht abrufbasiert)
– Datenformat: JSON
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 – API-Methode: GET
– Synchron (nicht abrufbasiert)
– Datenformat: JSON
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} – API-Methode: POST
– Asynchron (abrufbasiert)
– Datenformat: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 – API-Methode: POST
– Asynchron (abrufbasiert)
– Datenformat: CSV

Zuordnung der Datenfelder

In der folgenden Tabelle finden Sie eine Zusammenfassung der alten Felder, die in den von Ihnen derzeit verwendeten Lösungen verfügbar sind, sowie der Felder, die in den neuen Lösungen verwendet werden.

Altes Feld Neues Feld Kommentare
accountId Nicht verfügbar – Verwenden Sie AccountName, um die Kontoinformationen abzurufen.
. AccountName
accountOwnerEmail AccountOwnerId
additionalInfo AdditionalInfo
chargesBilledSeparately isAzureCreditEligible Die Eigenschaften stehen im Widerspruch zueinander. Wenn isAzureCreditEnabled wahr, wäre ChargesBilledSeparately falsch.
consumedQuantity Menge
consumedService ConsumedService
consumedServiceId ConsumedService consumedServiceId liefert nur einen Zahlenwert.
ConsumedService gibt nur den Namen des Diensts an.
cost CostInBillingCurrency
costCenter CostCenter
Datum Date Das Format im alten Feld war jjjj-mm-tt, während das neue Feld im Format mm/tt/jjjj liegt.
departmentId InvoiceSectionId Das Feld ist momentan leer. Verwenden Sie DepartmentName, um die Abteilungsinformationen abzurufen.
departmentName InvoiceSectionName
extendedCost CostInBillingCurrency
instanceId resourceId
isRecurringCharge Verwenden Sie gegebenenfalls die Frequency und Term fields bewegende Nutzung.
location ResourceLocationNormalized ResourceLocationNormalized ist im Bericht "Kostendetails" vorhanden, aber noch nicht in den Exporten.
meterCategory MeterCategory
meterId MeterId
meterName MeterName
meterRegion MeterRegion
meterSubCategory MeterSubCategory
offerId OfferId
orderNumber Nicht verfügbar.
partNumber PartNumber
planName PlanName
product ProductName
publisherName PublisherName
Ressourcengruppe ResourceGroup
resourceGuid MeterId Die Werte können variieren. resourceGuid ist ein GUID-Wert. meterId ist eine lange Zahl.
resourceLocation ResourceLocation
resourceLocationId Nicht verfügbar.
resourceRate EffectivePrice
serviceInfo1 ServiceInfo1
serviceInfo2 ServiceInfo2
serviceName MeterCategory
serviceTier MeterSubCategory
storeServiceIdentifier Nicht verfügbar.
subscriptionGuid SubscriptionId
subscriptionId SubscriptionId
subscriptionName SubscriptionName
Tags Tags Das neue Feld enthält nicht die Umschließung {} der Schlüssel-Wert-Paare.
unitOfMeasure UnitOfMeasure