Dela via


Hämta all analysinformation för prenumerationer

gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Den här artikeln beskriver hur du hämtar all prenumerationsanalysinformation för dina kunder.

Förutsättningar

  • Autentiseringsuppgifter enligt beskrivningen i Partner Center-autentisering. Det här scenariot stöder endast autentisering med användarautentiseringsuppgifter.

REST-begäran

Syntax för begäran

Metod Begäran-URI
GET {baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

URI parametrar

I följande tabell visas valfria parametrar och deras beskrivningar:

Parameter Typ Beskrivning
topp Int Antalet rader med data som ska returneras i begäran. Om värdet inte anges är det högsta värdet och standardvärdet 10000. Om det finns fler rader i frågan innehåller svarstexten en nästa länk som du kan använda för att begära nästa sida med data.
hoppa över Int Antalet rader som ska hoppa över i frågan. Använd den här parametern för att bläddra igenom stora datamängder. Till exempel hämtar top=10000 och skip=0 de första 10 000 raderna med data, top=10000 och skip=10000 hämtar de kommande 10 000 dataraderna.
filter sträng En eller flera instruktioner som filtrerar raderna i svaret. Varje filtersats innehåller ett fältnamn från svarstexten och ett värde som är associerat med eq, neeller för vissa fält, contains operatorn. Uttalanden kan kombineras med and eller or. Strängvärden måste omges av enkla citattecken i -filtret parametern. I följande avsnitt finns en lista över fält som kan filtreras och de operatorer som stöds med dessa fält.
aggregationsnivå sträng Anger det tidsintervall för vilket aggregerade data ska hämtas. Kan vara någon av följande strängar: dag, veckaeller månad. Om värdet inte anges är standardvärdet dateRange. Den här parametern gäller endast när ett datumfält skickas som en del av parametern groupBy.
groupBy sträng En instruktion som endast tillämpar dataaggregering på de angivna fälten.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begäranens innehåll

Ingen.

Exempel på begäran

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

REST-svar

Om det lyckas innehåller svarstexten en samling Prenumeration resurser.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och extra felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och fler parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

{
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "customerName": "TESTORG65656565",
    "customerMarket": "US",
    "id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
    "status": "ACTIVE",
    "productName": "OFFICE 365 BUSINESS PREMIUM",
    "subscriptionType": "Office",
    "autoRenewEnabled": true,
    "partnerId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "friendlyName": "FULL OFFICE SUITE",
    "partnerName": "Partner Name",
    "providerName": "Provider Name",
    "creationDate": "2016-02-04T19:29:38.037",
   "effectiveStartDate": "2016-02-04T00:00:00",
    "commitmentEndDate": "2019-02-10T00:00:00",
    "currentStateEndDate": "2019-02-10T00:00:00",
    "trialToPaidConversionDate": null,
    "trialStartDate": null,
    "trialEndDate": null,
    "lastUsageDate": null,
    "deprovisionedDate": null,
    "lastRenewalDate": "2018-02-10T02:39:57.729",
    "licenseCount": 2,
    "churnRisk": "High",
    "billingCycleName": "MONTHLY"

}

Se även