Fakturerad och ej fakturerad dagligen klassificerad användningsavstämning API v2 (GA)

Gäller för: Partnercenter (ej tillgängligt i Azure Government eller Azure China 21Vianet.)

Våra asynkrona API:er erbjuder ett snabbare och mer hanterbart sätt att komma åt fakturerings- och avstämningsdata via Azure-blobar. Med dessa API:er behöver du inte hålla anslutningen öppen i timmar eller loopa genom batcharna med 2 000 radobjekt.

Vi har optimerat våra nya API:er för daglig användningsavstämning med hjälp av valet-nyckel och asynkrona mönster för begärandesvar . När du använder dessa API:er får du en token som du kan använda för att komma åt antingen alla attribut eller en delmängd av de dagliga klassificerade användningsavstämningsdata.

Du kan använda dessa API:er för det offentliga/globala MS Graph-molnet först nu. De är ännu inte tillgängliga för Azure Government eller Azure China 21Vianet.

API-översikt

Om du vill hämta nya dagliga användningsradobjekt för handel asynkront använder du två API-slutpunkter. Så här gör du:

Slutpunkt för användningsradobjekt

Använd det här API:et för att hämta fakturerade eller ej fakturerade dagliga klassificerade användningsradobjekt. Du får http-status 202 och en URL i platsrubriken. Avsök den här URL:en med jämna mellanrum tills du får en lyckad status med en manifest-URL.

Slutpunkt för åtgärdsstatus

Om du vill få statusen lyckad fortsätter du att anropa det här API:et med jämna mellanrum. Om data inte är klara innehåller API-svaret ett återförsökshuvud för att berätta hur lång tid det tar att vänta innan du försöker igen. När åtgärden är klar får du en manifestresurs med en lagringsmapp där du kan ladda ned användningsdata. Svaret delar upp filerna i mindre delar för optimerat dataflöde och I/O-parallellitet.

Sekvensdiagram

Här är ett sekvensdiagram som visar stegen för att ladda ned avstämningsdata.

Åtgärdssekvens för användare

Följ dessa steg om du vill hämta nya dagliga förbrukningsavstämningsobjekt för handel :

Steg 1: Skicka begäran

Skicka en POST-begäran till API-slutpunkten.

Hämta poster för dagliga dagliga klassificerade användningsrader

Hämta nya dagliga användningsradsobjekt som inte fakturerats för handel för den aktuella eller senaste kalendermånaden eller faktureringsperioden.

API-begäran

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"

}

Begärandetext

Begärandehuvuden

Information om hur du begär huvuden för API :et finns i Tillförlitlighet och support.

API-svar

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

När du använder API:et returneras vanligtvis en HTTP 202-status. Information om andra möjliga statusar baserat på dina begäranden finns i Standard API-svarsstatusar.

Hämta fakturerade dagliga klassificerade användningsradobjekt

Hämta nya handelsfakturerade dagliga klassificerade användningsradobjekt för en faktura för den stängda faktureringsperioden.

API-begäran

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

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

Frågeparametrar

Ej tillämpligt

Begärandetext

Begärandehuvud

Begär rubriker för API:et. Mer information finns i tillförlitlighet och support.

API-svar

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

När du använder API:et returneras vanligtvis en HTTP 202-status. Andra möjliga statusar baserat på dina begäranden finns i Statusar.

Steg 2: Kontrollera status för begäran

Om du vill kontrollera status för en begäran väntar du på ett HTTP 200-svar med statusen "lyckades" eller "misslyckades". Om begäran lyckas anges manifest-URL:en i attributet "resourceLocation".

Hämta åtgärdsstatus

Hämtar status för en begäran.

API-begäran

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

Parametrar för begäran

Begärandehuvud

Information om hur du begär huvuden för API :et finns i Tillförlitlighet och support.

Begärandetext

Saknas.

Svarsstatus

Förutom http-standardstatusarna kan API:et returnera följande HTTP-status:

Svarsnyttolast

API-svarsnyttolasten innehåller följande attribut:

Resursplatsobjekt

API-begäran

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

API-svar

Svaret rekommenderar att du väntar i 10 sekunder innan du försöker igen när du bearbetar data.

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-begäran

(10 sekunder efter föregående begäran...)

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

API-svar

API:et returnerar statusen "lyckades" och URI:n för "resourceLocation".

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": "0e195b37-4574-4539-bc42-0e539b9684c0",

        "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"

            }

        \]

    }

}

Steg 3: Ladda ned dagliga klassificerade radobjekt för användningsavstämning från Azure Blob Storage

Hämta sas-token (signatur för delad åtkomst) och bloblagringsplatsen från "sasToken" och "rootDirectory" egenskaperna för api-svaret för manifestnyttolasten. Använd Azure Storage SDK/-verktyget för att ladda ned och packa upp blobfilen. Den är i JSONLines-format .

Standard-API-svarsstatusar

Du kan få dessa HTTP-statusar från API-svaret:

Jämför beta- och GA-versioner

Se jämförelsetabellen för att förstå skillnaderna mellan betaversionerna och allmänt tillgängliga (GA). Om du använder betaversionen bör det vara enkelt att byta till ga-versionen.

Objektattribut för dagliga klassificerade användningsavstämningsobjekt

Om du vill jämföra attributen som returneras av API:et för daglig klassificering av användning för attributuppsättningarna "full" eller "basic" läser du följande information. Mer information om dessa attribut finns i den här dokumentationen.

Exempelkod

Mer information finns i API-exempel för Partnercenter: Hämta faktureringsrekonfigureringsdata.