Verwenden der Microsoft Graph-API zum Exportieren von Partnerabrechnungsdaten

Hinweis

Diese API ist nur für CSP-Partner (Cloud Solution Provider) verfügbar, um auf ihre abgerechneten und nicht abgerechneten Abstimmungsdaten für einen Mandanten zuzugreifen. Weitere Informationen zum CSP-Programm finden Sie unter Microsoft Cloud Solution Provider.

Als Teil des Microsoft Partner Center-Ökosystems können direkte Microsoft-Partner in den Cloud Solution Provider-Programmen anfordern, ihre abgerechneten und nicht berechneten Daten asynchron in Azure Blob Storage zu exportieren. Dadurch entfällt die Notwendigkeit, stundenlang eine offene Verbindung aufrechtzuerhalten und Millionen von Transaktionen iterativ zu durchlaufen. Die asynchrone API bietet eine Möglichkeit, schnell auf Abrechnungs- und Abstimmungsdaten in verwaltbaren Blöcken zuzugreifen.

Die Partnerabrechnungs-API ist im OData-Unternamespace microsoft.graph.partners.billingdefiniert.

Hinweis

Die tägliche Nutzung dauert normalerweise 24 Stunden, bis sie im Microsoft Partner Center angezeigt wird oder über die API verfügbar ist.

Authorization

Um Abstimmungsdaten zu exportieren, muss sich der aufrufende Prinzipal im Partnermandanten befinden und die entsprechenden Berechtigungen für die Partnerabrechnung erhalten. Die Partnerabrechnungs-API unterstützt die folgenden Partnerberechtigungen.

Berechtigungstyp	Berechtigung mit den geringsten Rechten	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	PartnerBilling.Read.All	Nicht unterstützt
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	PartnerBilling.Read.All	Nicht unterstützt

Zero Trust

Dieses Feature hilft Organisationen, ihre Identitäten an den drei Leitprinzipien einer Zero Trust-Architektur auszurichten:

• Explizit verifizieren
• Verwenden der geringsten Rechte
• Gehe von einem Verstoß aus

Weitere Informationen zu Zero Trust und anderen Möglichkeiten, Ihre organization an den Leitprinzipien auszurichten, finden Sie im Zero Trust Guidance Center.

Allgemeine Anwendungsfälle

Die Partnerabrechnungs-API bietet Methoden und Aktionen, mit denen direkte Microsoft-Partner ihre abgerechneten Abstimmungsdaten mit hohem Volumen sowie abgerechnete und nicht abgerechnete Azure-Nutzungsdaten exportieren können.

Abgerechnete Nutzungsdaten

Anwendungsfall	API
Erstellen eines neuen Exportvorgangs zum Exportieren abgerechneter Nutzungsdaten	billedUsage: export
Abrufen des Vorgangs status Aktualisieren	Get-Vorgang

Nicht abgerechnete Nutzungsdaten

Anwendungsfall	API
Erstellen eines neuen Exportvorgangs zum Exportieren nicht abgerechneter Nutzungsdaten	unbilledUsage: export
Abrufen des Vorgangs status Aktualisieren	Get-Vorgang

Abgleichsdaten für abgerechnete Rechnungen

Anwendungsfall	API
Erstellen eines neuen Exportvorgangs zum Exportieren abgerechneter Rechnungsabstimmungsdaten	billedReconciliation: export
Abrufen des Vorgangs status Aktualisieren	Get-Vorgang

Asynchroner Datenabruf

Das Herunterladen von Nutzungs- oder Abstimmungsdaten ist ein zeitintensiver Vorgang, der aus den folgenden Vorgängen besteht.

Verwendungspositionspositionsendpunkt

Verwenden Sie die API billedUsage: export or unbilledUsage: export, um auf abgerechnete oder nicht abgerechnete Verbrauchspositionen zuzugreifen. Die API gibt einen 202 Accepted Antwortcode und einen Location Header zurück, der die URL zum zeitintensiven Vorgang enthält. Sie können die status des zeitintensiven Vorgangs überprüfen, indem Sie in regelmäßigen Abständen eine GET-Anforderung ausführen, bis Sie eine erfolgreiche status mit einer Manifest-URL erhalten.

Nicht verwendeter Zeilenelementendpunkt

Verwenden Sie die api billedReconciliation: export , um auf Rechnungsabstimmungspositionen zuzugreifen. Die API gibt einen 202 Accepted Antwortcode und einen Location Header zurück, der die URL zum zeitintensiven Vorgang enthält. Sie können die status des zeitintensiven Vorgangs überprüfen, indem Sie in regelmäßigen Abständen eine GET-Anforderung ausführen, bis Sie eine erfolgreiche status mit einer Manifest-URL erhalten.

Vorgang status Endpunkt

Bis Sie die erfolgreiche status erhalten, rufen Sie die Get-Vorgangs-API in regelmäßigen Abständen ab. Wenn die angeforderten Daten nicht verfügbar sind, enthält die API-Antwort einen Retry-After Header, der angibt, wie lange Vor dem Senden einer weiteren Anforderung gewartet werden soll. Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält die Antwort auch ein Manifest mit Details zu den generierten Dateien. Das Manifest stellt einen Speicherordner bereit, aus dem die tatsächlichen Abrechnungsdaten heruntergeladen werden können. Die Antwort teilt oder partitioniert die Dateien, um den Durchsatz und die E/A-Parallelität zu optimieren.