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.
- Machen Sie sich mit dem neuen Abrechnungskonto für eine Microsoft-Kundenvereinbarung vertraut.
- Ermitteln Sie, welche APIs Sie verwenden, und sehen Sie im folgenden Abschnitt nach, welche ersetzt werden.
- Machen Sie sich mit Azure Resource Manager-REST-APIs vertraut.
- Wenn Sie Azure Resource Manager-APIs noch nicht verwenden, registrieren Sie Ihre Client-App in Microsoft Entra ID.
- Gewähren Sie der Anwendung, die während Microsoft Entra App-Registrierung erstellt wurde, Lesezugriff auf das Abrechnungskonto mithilfe der Zugriffssteuerung (IAM).
- Aktualisieren Sie Programmcode für die Verwendung der Microsoft Entra-Authentifizierung.
- Aktualisieren Sie Programmcode, sodass Aufrufe der EA-APIs durch Aufrufe der MCA-APIs ersetzt werden.
- Aktualisieren Sie die Fehlerbehandlung für die Verwendung neuer Fehlercodes.
- Prüfen Sie andere Integrationsangebote wie Power BI auf weitere erforderliche Aktionen.
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
Am 1. Mai 2024 werden Azure Enterprise Reporting-APIs eingestellt. Alle verbleibenden Enterprise-Berichterstellungs-APIs reagieren nicht mehr auf Anforderungen. Kunden müssen vorher auf die Verwendung von Microsoft Cost Management-APIs umsteigen. Weitere Informationen finden Sie unter Übersicht über die Migration von der Berichterstellung mit Azure Enterprise zu Kostenverwaltungs-APIs von Microsoft.
| 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|csv Microsoft.Billing/billingAccounts/…/billingProfiles/…/invoices/… /pricesheet/default/download format=json|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/reservationDetailsMicrosoft.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 API zum Abrufen der Saldozusammenfassung bietet Ihnen eine monatliche Übersicht über:
- 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.
- Abrufen von Nutzungsdetails/download
- Abrufen von Nutzungsdetails/submit
- Abrufen von Nutzungsdetails/usagedetails
- Abrufen von Nutzungsdetails/usagedetailsbycustomdate
- Abrufen von Marketplace Store-Gebühren/marketplacecharges
- Abrufen von Marketplace Store-Gebühren/marketplacechargesbycustomdate
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 | |
| 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.
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/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/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/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/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/28ae4b7f-41bb-581e-9fa4-8270c857aa5f/billingProfiles/ef37facb-cd6f-437a-9261-65df15b673f9/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:
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).
Nächste Schritte
- 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.