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 , ne eller 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"
}