Freigeben über


Migrieren von Enterprise Agreement-APIs zu APIs der Microsoft-Kundenvereinbarung

Dieser Artikel hilft Ihnen, die Unterschiede bezüglich Datenstruktur, API und anderer Aspekte der Systemintegration zwischen EA-Konten (Enterprise Agreement) und MCA-Konten (Microsoft-Kundenvereinbarung) zu verstehen. Cost Management unterstützt APIs für beide Kontotypen. Lesen Sie den Artikel zum Einrichten des Abrechnungskontos für eine Microsoft-Kundenvereinbarung, bevor Sie fortfahren.

Organisationen mit einem bestehenden EA-Konto sollten diesen Artikel beim Einrichten eines MCA-Kontos lesen. Zuvor waren zur Erneuerung eines EA-Kontos einige minimale Arbeitsschritte für den Wechseln von einer alten Registrierung zu einer neuen Registrierung erforderlich. Das Migrieren zu einem MCA-Konto erfordert jedoch zusätzlichen Aufwand. Der zusätzliche Aufwand ergibt sich durch Änderungen im zugrunde liegenden Abrechnungssubsystem, die sich auf alle kostenbezogenen APIs und Dienstangebote auswirken.

MCA-APIs und Integration

MCA-APIs und die neue Integration bieten Ihnen folgende Möglichkeiten:

  • Vollständige API-Verfügbarkeit durch native Azure-APIs
  • Konfigurieren mehrerer Rechnungen in einem einzigen Abrechnungskonto
  • Zugreifen auf eine kombinierte API mit Nutzung von Azure-Diensten, Nutzung des Marketplace von Drittanbietern und Marketplace-Einkäufen
  • Anzeigen von Kosten für alle Abrechnungsprofile (entsprechen den Registrierungen) mithilfe von Cost Management
  • Zugreifen auf neue APIs zum Anzeigen von Kosten, Benachrichtigung, wenn Kosten vorab definierte Schwellenwerte überschreiten, und automatisches Exportieren von Rohdaten

Migrationscheckliste

Die folgenden Punkte helfen Ihnen beim Übergang zu MCA-APIs.

Durch MCA-APIs ersetzte EA-APIs

EA-APIs verwenden einen API-Schlüssel zur Authentifizierung und Autorisierung. MCA APIs Verwendung der Microsoft Entra-Authentifizierung.

Hinweis

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

Zweck EA-API MCA-API
Saldo und Guthaben /balancesummary Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae
Nutzung (JSON) /usagedetails
/usagedetailsbycustomdate
Auswählen einer Lösung für Kostendetails
Nutzung (CSV) /usagedetails/download
/usagedetails/submit
Auswählen einer Lösung für Kostendetails
Marketplace-Nutzung (CSV) /marketplacecharges
/marketplacechargesbycustomdate
Auswählen einer Lösung für Kostendetails
Abrechnungszeiträume /billingperiods Microsoft.Billing/billingAccounts/billingProfiles/invoices
Preisblatt /pricesheet Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json oder csv
Microsoft.Billing/billingAccounts/…/billingProfiles/…/invoices/… /pricesheet/default/download format=json oder csv
Microsoft.Billing/billingAccounts/../billingProfiles/../providers/Microsoft.Consumption/pricesheets/download
Reservierungseinkäufe /reservationcharges Microsoft.Billing/billingAccounts/billingProfiles/transactions
Reservierungsempfehlungen /SharedReservationRecommendations
/SingleReservationRecommendations
Microsoft.Consumption/reservationRecommendations
Reservierungsnutzung /reservationdetails
/reservationsummaries
Microsoft.Consumption/reservationDetails
Microsoft.Consumption/reservationSummaries

¹ Nutzung von Azure-Diensten und Marketplace eines Drittanbieters sind über der Nutzungsdetails-API verfügbar.

Die folgenden APIs stehen für MCA-Abrechnungskonten zur Verfügung:

Zweck MCA-API (Microsoft-Kundenvereinbarung)
Abrechnungskonten² Microsoft.Billing/billingAccounts
Abrechnungsprofile² Microsoft.Billing/billingAccounts/billingProfiles
Rechnungsabschnitte² Microsoft.Billing/billingAccounts/invoiceSections
Invoices Microsoft.Billing/billingAccounts/billingProfiles/invoices
Abrechnungsabonnements {scope}/billingSubscriptions

² APIs geben Objektlisten zurück. Hierbei handelt es sich um Bereiche, in denen Cost Management-Funktionen im Azure-Portal und in APIs ausgeführt werden. Weitere Informationen zu Cost Management-Bereichen finden Sie unter Verstehen von und Arbeiten mit Bereichen.

Wenn Sie vorhandene EA-APIs verwenden, müssen Sie diese für die Unterstützung von MCA-Abrechnungskonten aktualisieren. In der folgenden Tabelle sind weitere Integrationsänderungen angegeben:

Zweck Altes Angebot Neues Angebot
Power BI Microsoft Consumption Insights-Inhaltspaket und -Connector Azure Consumption Insights-Connector

APIs zum Abrufen von Saldo und Guthaben

Die Get Balance-Zusammenfassung wurde verwendet, um Ihnen eine monatliche Zusammenfassung für Folgendes zu liefern:

  • Bilanzen
  • Neue Einkäufe
  • Gebühren für den Azure Marketplace-Dienst
  • Adjustments
  • Gebühren für Dienstüberschreitung

Alle Nutzungs-APIs werden durch native Azure-APIs ersetzt, die Microsoft Entra ID zur Authentifizierung und Autorisierung verwenden. Weitere Informationen zum Aufrufen von Azure-REST-APIs finden Sie unter Erste Schritte mit der REST-API.

Die API zum Abrufen der Saldozusammenfassung wird durch die Microsoft.Billing/billingAccounts/billingProfiles/availableBalance-API ersetzt.

Zum Abrufen verfügbarer Salden mit der API für verfügbare Salden gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview

APIs zum Abrufen von Kosten und Nutzung

Mit den folgenden APIs können Sie eine tägliche Aufschlüsselung der Kosten für die Nutzung der Azure-Dienste, des Marketplace von Drittanbietern und andere Marketplace-Einkäufe abrufen. Die folgenden getrennten APIs wurden für die Nutzung der Azure-Dienste und des Marketplace von Drittanbietern zusammengeführt. Die alten APIs werden durch Exporte oder die Kostendetails-API ersetzt. Informationen zum Auswählen der für Sie geeigneten Lösung finden Sie unter Auswählen einer Lösung für Kostendetails. Beide Lösungen bieten dieselbe Datei mit Kostendetails und weisen Marketplace-Einkäufe in den Daten auf, die zuvor nur in der aktuellen Saldozusammenfassung angezeigt wurden.

Exporte und die Kostendetails-API sind wie alle Cost Management-APIs in mehreren Bereichen verfügbar. Verwenden Sie für berechnete Kosten, die Sie normalerweise auf Registrierungsebene erhalten würden, den Bereich des Abrechnungsprofils. Weitere Informationen zu Cost Management-Bereichen finden Sie unter Verstehen von und Arbeiten mit Bereichen.

Type ID-Format
Abrechnungskonto /Microsoft.Billing/billingAccounts/{billingAccountId}
Abrechnungsprofil /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}
Subscription /subscriptions/{subscriptionId}
Ressourcengruppe /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}

Einige Eigenschaftennamen wurden in dem neuen Datenset mit Kostendetails geändert, der über Exporte und die Kostendetails-API verfügbar ist. Die folgende Tabelle zeigt die sich jeweils entsprechenden Eigenschaften.

Alte Eigenschaft Neue Eigenschaft Hinweise
AccountId Der Abonnementersteller wird nicht nachverfolgt. Verwenden Sie invoiceSectionId (entspricht departmentID).
AccountNameAccountOwnerId und AccountOwnerEmail Der Abonnementersteller wird nicht nachverfolgt. Verwenden Sie invoiceSectionName (entspricht departmentName).
AdditionalInfo additionalInfo
ChargesBilledSeparately isAzureCreditEligible Die Eigenschaften stehen im Widerspruch zueinander. Wenn IsAzureCreditEnabled auf „true“ festgelegt ist, weist ChargesBilledSeparately den Wert „false“ auf.
ConsumedQuantity quantity
ConsumedService consumedService Genaue Zeichenfolgenwerte können abweichen.
ConsumedServiceId Keine
CostCenter costCenter
Date und usageStartDate date
Tag Keine Analysiert den Tag ab Datum.
DepartmentId invoiceSectionId Genaue Werte abweichend.
DepartmentName invoiceSectionName Genaue Zeichenfolgenwerte können abweichen. Konfigurieren Sie Rechnungsabschnitte ggf. entsprechend den Abteilungen.
ExtendedCost und Cost costInBillingCurrency
InstanceId resourceId
Is Recurring Charge Keine
Standort location
MeterCategory meterCategory Genaue Zeichenfolgenwerte können abweichen.
MeterId meterId Genaue Zeichenfolgenwerte abweichend.
MeterName meterName Genaue Zeichenfolgenwerte können abweichen.
MeterRegion meterRegion Genaue Zeichenfolgenwerte können abweichen.
MeterSubCategory meterSubCategory Genaue Zeichenfolgenwerte können abweichen.
Month Keine Analysiert den Monat ab Datum.
Angebotsname Keine Verwenden Sie publisherName und productOrderName.
OfferID Keine
Order Number Keine
PartNumber Keine Verwenden Sie meterId und productOrderName zur eindeutigen Identifizierung von Preisen.
Plan Name productOrderName
Produkt Produkt
ProductId productId Genaue Zeichenfolgenwerte abweichend.
Name des Herausgebers publisherName
ResourceGroup resourceGroupName
ResourceGuid meterId Genaue Zeichenfolgenwerte abweichend.
ResourceLocation resourceLocation
ResourceLocationId Keine
Ressourcenname Keine
ResourceRate effectivePrice
ServiceAdministratorId
ServiceInfo1 serviceInfo1
ServiceInfo2 serviceInfo2
Dienstname meterCategory Genaue Zeichenfolgenwerte können abweichen.
ServiceTier meterSubCategory Genaue Zeichenfolgenwerte können abweichen.
StoreServiceIdentifier
SubscriptionGuid subscriptionId
SubscriptionId subscriptionId
SubscriptionName subscriptionName
`Tags` tags Die tags-Eigenschaft gilt für das Stammobjekt und nicht für die geschachtelte properties-Eigenschaft.
UnitOfMeasure unitOfMeasure Genaue Zeichenfolgenwerte abweichend.
usageEndDate date
Year Keine Analysiert das Jahr ab Datum.
(neu) billingCurrency Die für die Gebühr verwendete Währung.
(neu) billingProfileId Eindeutige ID für das Abrechnungsprofil (entspricht der Registrierung).
(neu) billingProfileName Name des Abrechnungsprofils (entspricht der Registrierung).
(neu) chargeType Wird zur Unterscheidung zwischen Nutzung der Azure-Dienste, Marketplace-Nutzung und Einkäufen verwendet.
(neu) invoiceId Eindeutige ID für die Rechnung. Für den aktuellen, offenen Monat leer.
(neu) publisherType Der Typ des Herausgebers für Einkäufe. Zur Verwendung leer.
(neu) serviceFamily Typ des Einkaufs. Zur Verwendung leer.
(neu) servicePeriodEndDate Enddatum für den erworbenen Dienst.
(neu) servicePeriodStartDate Startdatum für den erworbenen Dienst.

API für Abrechnungszeiträume durch Rechnungen-API ersetzt

MCA-Abrechnungskonten verwenden keine Abrechnungszeiträume. Stattdessen werden Rechnungen verwenden, um Kosten auf bestimmte Abrechnungszeiträume zu begrenzen. Die API für Abrechnungszeiträume wird durch die Rechnungen-API ersetzt. Alle Nutzungs-APIs werden durch native Azure-APIs ersetzt, die Microsoft Entra ID zur Authentifizierung und Autorisierung verwenden. Weitere Informationen zum Aufrufen von Azure-REST-APIs finden Sie unter Erste Schritte mit der REST-API.

Zum Abrufen von Rechnungen mit der Rechnungen-API gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview

Preisblatt-APIs

In diesem Abschnitt werden vorhandene Preisblatt-APIs erläutert und Empfehlungen für den Übergang zur Preisblatt-API für Microsoft-Kundenvereinbarungen gegeben. Außerdem werden die Preisblatt-API für Microsoft-Kundenvereinbarungen sowie die Felder auf den Preisblättern erläutert. Die APIs zum Abrufen des Preisblatts für Unternehmen und zum Abrufen der Abrechnungszeiträume für Unternehmen werden durch die Preisblatt-API für Microsoft-Kundenvereinbarungen (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet) ersetzt. Die neue API unterstützt sowohl JSON- als auch CSV-Formate in asynchronen REST-Formaten. Alle Nutzungs-APIs werden durch native Azure-APIs ersetzt, die Microsoft Entra ID zur Authentifizierung und Autorisierung verwenden. Weitere Informationen zum Aufrufen von Azure-REST-APIs finden Sie unter Erste Schritte mit der REST-API.

Abrechnungs-APIs für Unternehmen

Bei Enterprise-Registrierungen wurden Abrechnungs-APIs für Unternehmen verwendet, um Informationen zu Preisen und Abrechnungszeiträumen zu erhalten. Authentifizierung und Autorisierung über Microsoft Entra-Web Token.

Zum Abrufen der geltenden Preise für die angegebene Enterprise-Registrierung mit den APIs für das Preisblatt und Abrechnungszeiträume gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet

Preisblatt-API für Microsoft-Kundenvereinbarungen

Verwenden Sie die Preisblatt-API für Microsoft-Kundenvereinbarungen, um Preise für alle Azure- und Marketplace-Nutzungsdienste anzuzeigen. Die für das Abrechnungsprofil angezeigten Preise gelten für alle Abonnements, die dem Abrechnungsprofil angehören.

Verwenden Sie die Preisblatt-API, um alle Preisblattdaten für Azure-Nutzungsdienste im CSV-Format anzuzeigen:

Methode Anforderungs-URI
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv

Verwenden Sie die Preisblatt-API, um alle Preisblattdaten für Azure-Nutzungsdienste im JSON-Format anzuzeigen:

Methode Anforderungs-URI
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json

Bei Verwendung der API wird das Preisblatt für das gesamte Konto zurückgegeben. Sie können aber auch eine verkürzte Version des Preisblatts im PDF-Format abrufen. Die Zusammenfassung enthält Azure- und Marketplace-Nutzungsdienste, die für eine bestimmte Rechnung berechnet werden. Die Rechnung wird durch die {InvoiceId} identifiziert, die der Rechnungsnummer entspricht, die in den PDF-Dateien der Rechnungszusammenfassung angegeben ist. Im Folgenden sehen Sie ein Beispiel.

Screenshot der Rechnungsnummer für die Rechnungs-ID

Zum Anzeigen von Rechnungsinformationen mit der Preisblatt-API im CSV-Format gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv

Zum Anzeigen von Rechnungsinformationen mit der Preisblatt-API im JSON-Format gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json

Sie können auch geschätzte Preise für jeden Azure- oder Marketplace-Nutzungsdienst im aktuellen offenen Abrechnungszyklus oder im Dienstzeitraum anzeigen.

Zum Anzeigen geschätzter Preise für Nutzungsdienste mit der Preisblatt-API im CSV-Format gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv

Zum Anzeigen geschätzter Preise für Nutzungsdienste mit der Preisblatt-API im JSON-Format gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json

Die Preisblatt-APIs für Microsoft-Kundenvereinbarungen sind asynchrone REST-APIs. Die Antworten für die APIs haben sich gegenüber den älteren synchronen APIs geändert. Der Textkörper der API-Antwort hat sich ebenfalls geändert.

Alter Antworttext

Hier sehen Sie ein Beispiel für die Antwort einer synchronen REST-API:

[
        {
            "id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
            "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
            "meterName": "A1 VM",
            "unitOfMeasure": "100 Hours",
            "includedQuantity": 0,
            "partNumber": "N7H-00015",
            "unitPrice": 0.00,
            "currencyCode": "USD"
        },
        {
    ]

Neuer Antworttext

Die APIs unterstützen das asynchrone Azure REST-Format. Rufen Sie die API mit GET auf, und Sie erhalten die folgende Antwort:

No Response Body

HTTP Status 202 Accepted

Die folgenden Header werden mit dem Speicherort der Ausgabe gesendet:

Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Retry-After: 10

OData-EntityId: {operationId}

Führen Sie einen weiteren GET-Aufruf für den Speicherort aus. Die Antwort auf den GET-Aufruf ist immer gleich, bis der Vorgang einen Abschluss- oder Fehlerstatus erreicht. Nach Abschluss des Vorgangs gibt die Antwort auf den GET-Aufruf für den Speicherort die Download-URL zurück, als ob der Vorgang gleichzeitig ausgeführt worden wäre. Hier sehen Sie ein Beispiel:

HTTP Status 200

{
  "id": "providers/Microsoft.Consumption/operationresults/{operationId}",
  "name": {operationId},
  "type": “Microsoft.Consumption/operationResults",
  "properties" : {
    "downloadUrl": {urltoblob},
    "validTill": "Date"
  }
}

Der Client kann auch einen GET-Aufruf für Azure-AsyncOperation starten. Der Endpunkt gibt den Status für den Vorgang zurück.

In der folgenden Tabelle sind Felder in der älteren API zum Abrufen des Preisblatts für Unternehmen aufgelistet. Die Tabelle enthält auch die entsprechenden Felder im neuen Preisblatt für Microsoft-Kundenvereinbarungen:

Alte Eigenschaft Neue Eigenschaft Hinweise
billingPeriodId Nicht zutreffend Nicht zutreffend Bei Microsoft-Kundenvereinbarungen wurde das Konzept der billingPeriodId durch die Rechnung und das zugehörige Preisblatt ersetzt.
meterId meterId
unitOfMeasure unitOfMeasure Genaue Zeichenfolgenwerte können abweichen.
includedQuantity includedQuantity Gilt nicht für Dienste in Microsoft-Kundenvereinbarungen.
partNumber Nicht zutreffend Verwenden Sie stattdessen eine Kombination aus productOrderName (entspricht offerID) und meterID.
unitPrice unitPrice Der Einzelpreis gilt für Dienste, die in Microsoft-Kundenvereinbarungen genutzt werden.
currencyCode pricingCurrency Bei Microsoft-Kundenvereinbarungen werden Preise in Preis- und Abrechnungswährung dargestellt. CurrencyCode entspricht pricingCurrency in Microsoft-Kundenvereinbarungen.
offerID productOrderName Anstelle von OfferID können Sie productOrderName verwenden, doch ist dies nicht mit OfferID identisch. ProductOrderName und meter bestimmen jedoch die Preise in Microsoft-Kundenvereinbarungen in Bezug auf meterId und OfferID in Legacyregistrierungen.

Vorgänge der Preisblatt-API für die Nutzung

Bei Enterprise Agreements haben Sie die Vorgänge Abrufen und Abrufen nach Abrechnungszeitraum der Preisblatt-API für die Nutzung für einen Bereich nach subscriptionId oder einen Abrechnungszeitraum verwendet. Die API verwendet die Azure Resource Manager-Authentifizierung.

Zum Abrufen der Preisblattinformationen für einen Bereich mit der Preisblatt-API gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01

Zum Abrufen von Preisblattinformationen nach Abrechnungszeitraum mit der Preisblatt-API gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01

Verwenden Sie anstelle der oben genannten API-Endpunkte die nachfolgend aufgeführten für Microsoft-Kundenvereinbarungen:

Preisblatt-API für Microsoft-Kundenvereinbarungen (asynchrone REST-API)

Diese API wird für Microsoft-Kundenvereinbarungen verwendet und bietet zusätzliche Attribute.

Preisblatt für einen Bereich des Abrechnungsprofils in einem Abrechnungskonto

Diese API ist die vorhandene API. Sie wurde aktualisiert, um das Preisblatt für ein Abrechnungsprofil in einem Abrechnungskonto bereitzustellen.

Preisblatt für einen Bereich nach Abrechnungskonto

Die Azure Resource Manager-Authentifizierung wird verwendet, wenn Sie das Preisblatt für den Bereich der Registrierung in einem Abrechnungskonto abrufen.

Zum Abrufen des Preisblatts für den Bereich der Registrierung in einem Abrechnungskonto gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01

Verwenden Sie für eine Microsoft-Kundenvereinbarung die Informationen im folgenden Abschnitt. Dort sind die Feldeigenschaften angegeben, die für Microsoft-Kundenvereinbarungen verwendet werden.

Preisblatt für einen Bereich des Abrechnungsprofils in einem Abrechnungskonto

Beim aktualisierten Preisblatt nach Abrechnungskonto-API wird das Preisblatt im CSV-Format abgerufen. Zum Abrufen des Preisblatts für den Bereich des Abrechnungsprofils für eine MCA gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01

Im Bereich der EA-Registrierung sind die API-Antwort und Eigenschaften identisch. Die Eigenschaften entsprechen den jeweiligen MCA-Eigenschaften.

Die älteren Eigenschaften für Azure Resource Manager-Preisblatt-APIs und die entsprechenden neuen Eigenschaften sind in der folgenden Tabelle enthalten.

Alte Eigenschaft der Azure Resource Manager-Preisblatt-API Neue Eigenschaft der Preisblatt-API für Microsoft-Kundenvereinbarungen Beschreibung
Messungs-ID meterId Eindeutiger Bezeichner für die Verbrauchseinheit. Entspricht meterID.
Meter name meterName Name der Verbrauchseinheit. Die Verbrauchseinheit stellt die bereitstellbare Ressource eines Azure-Diensts dar.
Kategorie für Messung Dienst Name der Klassifizierungskategorie der Verbrauchseinheit. Entspricht dem Dienst auf dem Preisblatt für die Microsoft-Kundenvereinbarung. Genaue Zeichenfolgenwerte abweichend.
Meter subcategory meterSubCategory Name der Unterklassifizierungskategorie der Verbrauchseinheit. Basierend auf der Klassifizierung der Unterschiede beim allgemeinen Funktionsumfang im Dienst, z.B. SQL-Datenbank (Basic) oder SQL-Datenbank (Standard).
Meter Region meterRegion
Einheit Nicht zutreffend Kann aus unitOfMeasure analysiert werden.
Unit of measure unitOfMeasure
Part number Nicht zutreffend Verwenden Sie anstelle von part number die Eigenschaften productOrderName und MeterID zur eindeutigen Identifizierung des Preises für ein Abrechnungsprofil. Felder werden in der MCA-Rechnung anstelle von part number in MCA-Rechnungen aufgeführt.
Unit price unitPrice Einzelpreis der Microsoft-Kundenvereinbarung.
Currency code pricingCurrency Bei Microsoft-Kundenvereinbarungen werden Preise in Preis- und Abrechnungswährung dargestellt. Currency code entspricht pricingCurrency in Microsoft-Kundenvereinbarungen.
Included quantity includedQuantity Gilt nicht für Dienste in Microsoft-Kundenvereinbarungen. Wird mit Nullwerten angezeigt.
Angebots-ID productOrderName Verwenden Sie anstelle von OfferID die Eigenschaft productOrderName. Ist nicht mit OfferID identisch, doch bestimmen productOrderName und meter die Preise in Microsoft-Kundenvereinbarungen. Bezieht sich auf meterID und OfferID in Legacyregistrierungen.

Der Preis für Microsoft-Kundenvereinbarungen ist anders definiert als bei Enterprise Agreements. Der Preis für Dienste bei der Enterprise-Registrierung ist für Produkt, Teilenummer, Verbrauchseinheit und Angebot eindeutig. Die Teilenummer wird bei Microsoft-Kundenvereinbarungen nicht verwendet.

Der Preis für den Azure-Nutzungsdienst, der Teil einer Microsoft-Kundenvereinbarung ist, ist für productOrderName und meterID eindeutig. Diese stellen die Verbrauchseinheit des Diensts und den Produktplan dar.

Zur Abstimmung zwischen dem Preisblatt und der Nutzung in der Nutzungsdetails-API können Sie productOrderName und meterID verwenden.

Benutzer, die über Rechte als Besitzer oder Mitwirkender des Abrechnungsprofils, Leseberechtigung für das Abrechnungsprofil und Rechte als Rechnungs-Manager verfügen, können das Preisblatt herunterladen.

Das Preisblatt enthält Preise für Dienste, deren Preis auf der Nutzung basiert. Die Dienste umfassen Azure-Nutzung und Marketplace-Nutzung. Der aktuelle Preis am Ende jedes Dienstzeitraums ist gesperrt und wird für die Nutzung in einem einzelnen Dienstzeitraum angewendet. Bei Azure-Nutzungsdiensten beträgt der Dienstzeitraum in der Regel einen Kalendermonat.

Nicht mehr verwendete Felder der Preisblatt-API

Die folgenden Felder sind entweder nicht in Preisblatt-APIs für Microsoft-Kundenvereinbarungen verfügbar oder diese weisen die gleichen Felder auf.

Nicht mehr verwendetes Feld Beschreibung
billingPeriodId Nicht zutreffend. Entspricht InvoiceId für MCA.
offerID Nicht zutreffend Entspricht productOrderName in MCA.
meterCategory Nicht zutreffend Entspricht Service in MCA.
unit Nicht zutreffend Kann aus unitOfMeasure analysiert werden.
currencyCode Entspricht pricingCurrency in MCA.
meterLocation Entspricht meterRegion in MCA.
partNumber Nicht zutreffend, da die Teilenummer in MCA-Rechnungen nicht aufgeführt wird. Verwenden Sie anstelle von part number die Kombination aus meterID und productOrderName zur eindeutigen Identifizierung von Preisen.
totalIncludedQuantity Nicht zutreffend
pretaxStandardRate Nicht zutreffend

API für reservierte Instanzgebühren ersetzt

Mit der API für reservierte Instanzgebühren können Sie Abrechnungstransaktionen für Reservierungseinkäufe abrufen. Die neue API umfasst alle Einkäufe, einschließlich Marketplace-Angeboten von Drittanbietern. Alle Nutzungs-APIs werden durch native Azure-APIs ersetzt, die Microsoft Entra ID zur Authentifizierung und Autorisierung verwenden. Weitere Informationen zum Aufrufen von Azure-REST-APIs finden Sie unter Erste Schritte mit der REST-API. Die API für reservierte Instanzgebühren wird durch die Transaktionen-API ersetzt.

Zum Abrufen von Reservierungserwerbtransaktionen mit der Transaktionen-API gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview

APIs für Empfehlungen ersetzt

APIs für Empfehlungen reservierter Instanzeinkäufe stellen die Nutzung virtueller Computer innerhalb der letzten 7, 30 oder 60 Tage bereit. APIs geben auch Empfehlungen für den Reservierungserwerb. Dazu gehören:

  • API für Empfehlungen zu freigegebenen reservierten Instanzen
  • API für Empfehlungen zu einzelnen reservierten Instanzen

Alle Nutzungs-APIs werden durch native Azure-APIs ersetzt, die Microsoft Entra ID zur Authentifizierung und Autorisierung verwenden. Weitere Informationen zum Aufrufen von Azure-REST-APIs finden Sie unter Erste Schritte mit der REST-API. Die zuvor aufgelisteten APIs für Reservierungsempfehlungen werden durch die Microsoft.Consumption/reservationRecommendations-API ersetzt.

Zum Abrufen von Reservierungsempfehlungen mit der API für Reservierungsempfehlungen gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01

APIs für Reservierungsnutzung ersetzt

Sie können die Reservierungsnutzung in einer Registrierung mit der API für die Nutzung reservierter Instanzen abrufen. Wenn mehr als eine reservierte Instanz in einer Registrierung vorhanden ist, können Sie auch die Nutzung aller Käufe reservierter Instanzen mit dieser API abrufen.

Dazu gehören:

  • Nutzungsdetails zu reservierten Instanzen
  • Nutzungszusammenfassung zu reservierten Instanzen

Alle Nutzungs-APIs werden durch native Azure-APIs ersetzt, die Microsoft Entra ID zur Authentifizierung und Autorisierung verwenden. Weitere Informationen zum Aufrufen von Azure-REST-APIs finden Sie unter Erste Schritte mit der REST-API. Die zuvor aufgelisteten APIs für Reservierungsempfehlungen werden durch die APIs Microsoft.Consumption/reservationDetails und Microsoft.Consumption/reservationSummaries ersetzt.

Zum Abrufen von Reservierungsdetails mit der API für Reservierungsdetails gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01

Zum Abrufen von Reservierungszusammenfassungen mit der API für Reservierungszusammenfassungen gehen Sie folgendermaßen vor:

Methode Anforderungs-URI
GET https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01

Power BI-Integration

Sie können Power BI auch für die Kostenberichterstattung verwenden. Mit dem Cost Management-Connector für Power BI Desktop können Sie leistungsstarke benutzerdefinierte Berichte erstellen, die Ihnen helfen, Ihre Azure-Ausgaben besser zu verstehen. Der Cost Management-Connector unterstützt derzeit Kunden mit einer Microsoft-Kundenvereinbarung oder einem Enterprise Agreement (EA).

  • Lesen Sie die Dokumentation zur Kostenverwaltung, und erfahren Sie, wie Sie Azure-Ausgaben überwachen und steuern. Dort finden Sie auch Informationen zum Optimieren der Ressourcennutzung mithilfe der Kostenverwaltung.