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 | ||
| . | 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 | |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | resourceId | |
| isRecurringCharge | Verwenden Sie gegebenenfalls die Frequency und Term fields bewegende Nutzung. |
|
| location | ResourceLocationNormalized | |
| 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 |