Abrufen aller Informationen zur Abonnementanalyse
Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government
In diesem Artikel wird beschrieben, wie Sie alle Abonnementanalyseinformationen für Ihre Kunden abrufen.
Voraussetzungen
- Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Authentifizierung mit Benutzeranmeldeinformationen.
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | {baseURL}/partner/v1/analytics/subscriptions HTTP/1.1 |
URI-Parameter
In der folgenden Tabelle sind optionale Parameter und deren Beschreibungen aufgeführt:
| Parameter | Type | Beschreibung |
|---|---|---|
| Oben | int | Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Wenn der Wert nicht angegeben ist, sind 10000der Maximalwert und der Standardwert . Wenn in der Abfrage weitere Zeilen vorhanden sind, enthält der Antworttext einen nächsten Link, den Sie verwenden können, um die nächste Seite mit Daten anzufordern. |
| skip | int | Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datasets zu durchlaufen. Ruft beispielsweise top=10000 skip=0 die ersten 10.000 Datenzeilen top=10000 ab und skip=10000 ruft die nächsten 10.000 Datenzeilen ab. |
| filter | Zeichenfolge | Eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Filter-Anweisung enthält einen Feldnamen aus dem Antworttext und einen Wert, der contains dem eqOperator zugeordnet ist, neoder für bestimmte Felder. Anweisungen können mithilfe and oder or. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filterparameter umgeben sein. Im folgenden Abschnitt finden Sie eine Liste der Felder, die gefiltert werden können, und die Operatoren, die mit diesen Feldern unterstützt werden. |
| aggregationLevel | Zeichenfolge | Gibt den Zeitraum an, für den aggregierte Daten abgerufen werden sollen. Dies kann eine der folgenden Zeichenfolgen sein: Tag, Woche oder Monat. Wenn der Wert nicht angegeben ist, ist "dateRange" der Standardwert. Dieser Parameter gilt nur, wenn ein Datumsfeld als Teil des groupBy-Parameters übergeben wird. |
| Groupby | Zeichenfolge | Eine Anweisung, die datenaggregation nur auf die angegebenen Felder anwendet. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
Keine.
Beispiel für eine Anfrage
GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0
REST-Antwort
Bei erfolgreicher Ausführung enthält der Antworttext eine Sammlung von Abonnementressourcen.
Erfolgs- und Fehlercodes der Antwort
Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und weitere Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.
Beispielantwort
{
"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"
}