Hämta all information om prenumerationsanalys

Artikel
09/22/2023

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 Partnercenter-autentisering. Det här scenariot stöder endast autentisering med användarautentiseringsuppgifter.

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

URI-parametrar

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

Parameter	Type	Beskrivning
top	heltal	Antalet rader med data som ska returneras i begäran. Om värdet inte har angetts är `10000`det högsta värdet och standardvärdet . 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	heltal	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 `top=10000` och `skip=0` hämtar 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 operatorn `eq``contains` , `ne`eller för vissa fält. Instruktioner kan kombineras med eller `and` `or`. Strängvärden måste omges av enkla citattecken i filterparametern. I följande avsnitt finns en lista över fält som kan filtreras och de operatorer som stöds med dessa fält.
aggregationLevel	sträng	Anger det tidsintervall för vilket aggregerade data ska hämtas. Kan vara en av följande strängar: dag, vecka eller 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ärandetext

Inga.

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 prenumerationsresurser.

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": "76906668-27FC-4F5B-A35C-75A9823E13AF",
    "customerName": "TESTORG65656565",
    "customerMarket": "US",
    "id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
    "status": "ACTIVE",
    "productName": "OFFICE 365 BUSINESS PREMIUM",
    "subscriptionType": "Office",
    "autoRenewEnabled": true,
    "partnerId": "3B33E682-00C3-41EE-9DD2-A548ADF56438",
    "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

Partnercenteranalys – resurser

Dela via