Verwenden der Microsoft Graph-API zum Exportieren von Partnerabrechnungsdaten
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
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 Mandanten 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 | Vorgang abrufen |
Nicht abgerechnete Nutzungsdaten
| Anwendungsfall | API |
|---|---|
| Erstellen eines neuen Exportvorgangs zum Exportieren nicht abgerechneter Nutzungsdaten | unbilledUsage: export |
| Abrufen des Vorgangs status Aktualisieren | Vorgang abrufen |
Abgleichsdaten für abgerechnete Rechnungen
| Anwendungsfall | API |
|---|---|
| Erstellen eines neuen Exportvorgangs zum Exportieren abgerechneter Rechnungsabstimmungsdaten | billedReconciliation: export |
| Abrufen des Vorgangs status Aktualisieren | Vorgang abrufen |
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.