Abgerechnete und nicht abgerechnete tägliche Nutzungsabstimmungs-API v2 (GA)

Gilt für: Partner Center (nicht verfügbar in Azure Government oder Azure China 21Vianet.)

Unsere neue asynchrone API bietet eine schnellere und effizientere Möglichkeit, über Azure-Blobs auf Ihre Abrechnungs- und Abstimmungsdaten zuzugreifen. Anstatt eine Verbindung für Stunden offen zu halten oder Batches von 2.000 Zeilenelementen zu verarbeiten, können Sie ihren Workflow jetzt optimieren.

Die neuen täglich bewerteten Nutzungssausgleichs-APIs verwenden erweiterte Techniken wie Valet-Schlüssel und asynchrone Anforderungsantwortmuster . Diese APIs bieten Ihnen ein SAS-Token (Shared Access Signature), das Sie verwenden können, um entweder auf alle Attribute oder eine Teilmenge der täglich bewerteten Nutzungsabstimmungsdaten zuzugreifen.

Unsere APIs verwenden optimierte Techniken, um Ihre Effizienz zu steigern, sodass Sie schnellere Ergebnisse mit weniger Aufwand erzielen können. Nutzen Sie diese APIs, um den Datenzugriff zu vereinfachen und Ihre Gesamteffizienz zu verbessern.

Sie können diese APIs derzeit nur für die öffentliche/globale Cloud von MS Graph verwenden. Sie sind für Azure Government oder Azure China 21Vianet noch nicht verfügbar.

API-Übersicht

Um Ihnen beim asynchronen Abrufen von täglich bewerteten E-Commerce-Nutzungspositionen zu helfen, bieten wir zwei wichtige API-Endpunkte an. Hier ist ein optimiertes Handbuch für die ersten Schritte:

Endpunkt für Verwendungszeilenelemente

Verwenden Sie zunächst diese API, um täglich bewertete Nutzungszeilenelemente für den neuen Commerce abzurufen. Wenn Sie eine Anforderung stellen, erhalten Sie einen HTTP-Status 202 und einen Speicherortheader mit einer URL. Rufen Sie diese URL regelmäßig ab, bis Sie einen Erfolgsstatus und eine Manifest-URL erhalten.

Vorgangsstatusendpunkt

Überprüfen Sie als Nächstes den Vorgangsstatus, indem Sie diese API in regelmäßigen Abständen aufrufen. Wenn die Daten nicht bereit sind, enthält die Antwort einen Retry-After-Header , der angibt, wie lange gewartet werden soll, bevor sie es erneut versuchen. Sobald der Vorgang abgeschlossen ist, erhalten Sie eine Manifestressource mit einem Speicherordnerlink zum Herunterladen der Nutzungsdaten. Die Antwortsegmente der Dateien, um den Durchsatz zu verbessern und die E/A-Parallelität zu ermöglichen.

Indem Sie diese Schritte ausführen, können Sie Ihren Rechnungsausgleichsprozess effizient verwalten.

Sequenzdiagramm

Hier ist ein Sequenzdiagramm, das die Schritte zum Herunterladen der Abstimmungsdaten zeigt.

Benutzeraktionssequenz

Führen Sie die folgenden Schritte aus, um neue E-Commerce-Artikel für die tägliche Nutzungsabstimmung abzurufen:

Schritt 1: Senden einer Anforderung

Senden Sie eine POST-Anforderung an den API-Endpunkt.

Abrufen nicht abgerechneter täglich bewerteter Nutzungspositionen

Erhalten Sie neue e-Commerce unbilligte täglich bewertete Nutzungspositionen für den aktuellen oder letzten Kalendermonat oder Abrechnungszeitraum.

API-Anforderung

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export

Accept: application/json

Content-Type: application/json

{

"currencyCode": "USD",

"billingPeriod": "current",

"attributeSet": "basic"

}

Anforderungstext

Anforderungsheader

Informationen zum Anfordern von Headern für die API finden Sie unter Zuverlässigkeit und Support.

API-Antwort

HTTP/1.1 202 Accepted  
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Die API antwortet in der Regel mit einem HTTP 202-Status. Je nach Ihren Anforderungen können auch andere Status auftreten. Diese Status werden im Abschnitt "Standard-API-Antwortstatus" aufgeführt.

Abrufen der täglich bewerteten Nutzungspositionen

Erhalten Sie neue, täglich bewertete Nutzungspositionen für eine Rechnung für den abgeschlossenen Abrechnungszeitraum.

API-Anforderung

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export

{  
"invoiceId": "G00012345",  
"attributeSet": "full"  
}

Abfrageparameter

N/V

Anforderungstext

Anforderungsheader

Anforderungsheader für die API. Weitere Informationen finden Sie unter Zuverlässigkeit und Support.

API-Antwort

HTTP/1.1 202 akzeptiert
Ort: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Wenn Sie die API verwenden, wird in der Regel ein HTTP 202-Status zurückgegeben. Weitere mögliche Status basierend auf Ihren Anforderungen finden Sie unter Statuses.

Schritt 2: Überprüfen des Anforderungsstatus

Um den Status einer Anforderung nachzuverfolgen, stellen Sie sicher, dass Sie eine HTTP 200-Antwort erhalten, die "erfolgreich" oder "fehlgeschlagen" angibt. Bei erfolgreicher Ausführung finden Sie die Manifest-URL im Attribut "resourceLocation". Dieses Attribut stellt einen Endpunkt für den Zugriff auf die erforderlichen Informationen bereit.

Vorgangsstatus abrufen

Ruft den Status einer Anforderung ab.

API-Anforderung

GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Anforderungsparameter

Anforderungsheader

Informationen zum Anfordern von Headern für die API finden Sie unter Zuverlässigkeit und Support.

Anforderungstext

Nicht zutreffend.

Antwortstatus

Abgesehen von den standardmäßigen HTTP-Status, die in Standard-API-Antwortstatus aufgeführt sind, kann die API auch den folgenden HTTP-Status zurückgeben:

Antwortnutzlast

Die API-Antwortnutzlast enthält die folgenden Attribute:

Ressourcenspeicherortobjekt

API-Anforderung

GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>

API-Antwort

Die Antwort empfiehlt, auf 10 Sekunden zu warten, bevor sie beim Verarbeiten von Daten erneut versucht wird.

HTTP/1.1 200 OK  
Retry-After: 10  
{  
"id": "9ab9cb54-d07f-4f52-9ea6-a09d7de52c14",  
"createdDateTime": "2022-06-1T10-01-03.4Z",  
"lastActionDateTime": "2022-06-1T10-01-05Z",  
"status": "running"  
}

API-Anforderung

(10 Sekunden nach der vorherigen Anforderung...)

GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>

API-Antwort

Die API gibt den Status "erfolgreich" und den URI für "resourceLocation" zurück.

HTTP/1.1 200 OK  
Content-Type: application/json  
{

    "@odata.context": "https://graph.microsoft.com/v1.0/\$metadata#reports/partners/billing/operations/\$entity",

    "@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation",

    "id": "f2170b13-6a8e-47d6-b481-6988490dc0cb",

    "createdDateTime": "2023-12-05T21:17:29Z",

    "lastActionDateTime": "2023-12-05T21:18:00.8897902Z",

    "status": "succeeded",

    "resourceLocation": {

        "id": "44e8500b-ab92-490e-8ac3-90500a1d3427",

        "createdDateTime": "2023-11-06T19:58:47.513Z",

        "schemaVersion": "2",

        "dataFormat": "compressedJSON",

        "partitionType": "default",

        "eTag": "RwDrn7fbiTXy6UULE",

        "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",

        "rootDirectory": "https://adlsreconbuprodeastus201.blob.core.windows.net/path_id",

        "sasToken": "{token}",

        "blobCount": 1,

        "blobs": \[

            {

                "name": "part-00123-5a93fa5d-749f-48bc-a372-9b021d93c3fa.c000.json.gz",

                "partitionValue": "default"

            }

        \]

    }

}

Schritt 3: Herunterladen täglich bewerteter Verwendungs-Abstimmungszeilenelemente aus Azure Blob Storage

Zunächst müssen Sie das SAS-Token (Shared Access Signature) und den Blob-Speicherort abrufen. Diese Details finden Sie in den Eigenschaften "sasToken" und "rootDirectory" der Manifestnutzlast-API-Antwort. Verwenden Sie dann das Azure Storage SDK/Tool, um die BLOB-Datei herunterzuladen und zu entzippen. Sie befindet sich im JSONLines-Format .

Standard-API-Antwortstatus

Möglicherweise erhalten Sie diese HTTP-Status aus der API-Antwort:

Vergleichen von Beta- und GA-Versionen

Sehen Sie sich die Vergleichstabelle an, um die Unterschiede zwischen der Betaversion und den allgemein verfügbaren (GA)-Versionen zu sehen. Wenn Sie derzeit die Betaversion verwenden, ist der Übergang zur GA-Version einfach und einfach.

Attribute des täglich bewerteten Nutzungsausgleichspostens

Informationen zum Vergleichen der Attribute, die von der Rechnungsabstimmungs-API für die Attributsätze "full" oder "basic" zurückgegeben werden, finden Sie in der folgenden Tabelle. Weitere Informationen zu diesen Attributen finden Sie in dieser Dokumentation.

Beispielcode

Informationen zur Verwendung dieser API finden Sie unter dem folgenden Link, der C#-Beispielcode enthält.

Partner Center-API-Beispiele: Abrufen von Abrechnungsdaten.