Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
anwendbar auf: Partnerzentrum | Partnerzentrum betrieben von 21Vianet | Partnerzentrum für die Microsoft-Cloud für die US-Regierung
So erhalten Sie alle Analyseinformationen für indirekte Wiederverkäufer für Ihre Kunden.
Voraussetzungen
- Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Authentifizierung mit Benutzeranmeldeinformationen.
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| ERHALTEN | {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1 |
URI-Parameter
| Parameter | Typ | BESCHREIBUNG |
|---|---|---|
| partnerTenantId | Schnur | Die Mandanten-ID des Partners, für den Sie Daten für indirekte Vertriebspartner abrufen möchten. |
| id | Schnur | Indirekte Reseller-ID |
| Name | Schnur | Der Name des Partners, für den Sie Daten für indirekte Vertriebspartner abrufen möchten. |
| Markt | Schnur | Der Markt des Partners, für den Sie Daten zu indirekten Vertriebspartnern abrufen möchten. |
| firstSubscriptionCreationDate | Zeichenfolge im UTC-Datums- und Zeitformat | Das Erstellungsdatum des ersten Abonnements, auf dessen Grundlage Sie Daten für indirekte Vertriebspartner abrufen möchten. |
| latestSubscriptionCreationDate | Zeichenfolge im UTC-Datums- und Zeitformat | Das Erstellungsdatum des letzten Abonnements. |
| firstSubscriptionEndDate | Zeichenfolge im UTC-Datums- und Zeitformat | Das erste Mal, dass ein Abonnement beendet wurde. |
| latestSubscriptionEndDate | Zeichenfolge im UTC-Datums- und Zeitformat | Spätestes Datum, an dem ein Abonnement beendet wurde. |
| firstSubscriptionSuspendedDate | Zeichenfolge in UTC Datum und Uhrzeit | Zum ersten Mal wurde ein Abonnement ausgesetzt. |
| latestSubscriptionSuspendedDate | Zeichenfolge im UTC-Datums- und Zeitformat | Spätestes Datum, an dem ein Abonnement ausgesetzt wurde. |
| firstSubscriptionDeprovisionedDate | Zeichenfolge im UTC-Datums- und Zeitformat | Die Bereitstellung eines Abonnements wurde zum ersten Mal aufgehoben. |
| latestSubscriptionDeprovisionedDate | Zeichenfolge im UTC-Datums- und Zeitformat | Spätestes Datum, an dem die Bereitstellung eines Abonnements aufgehoben wurde. |
| subscriptionCount | doppelt | Anzahl der Abonnements für alle Value-Added-Reseller |
| licenseCount (englisch) | doppelt | Anzahl der Lizenzen für alle Value-Added-Reseller. |
| indirectResellerCount | doppelt | Anzahl der indirekten Wiederverkäufer |
| Nach oben | Schnur | Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximalwert und der Standardwert, wenn er nicht angegeben ist, sind 10.000. 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. |
| hüpfen | INT | Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datensätze zu durchblättern. Ruft z. B top=10000 and skip=0 . die ersten 10.000 Datenzeilen ab, top=10000 and skip=10000 ruft die nächsten 10.000 Datenzeilen ab usw. |
| Filter | Schnur | Der Filter Parameter der Anforderung enthält eine oder mehrere Anweisungen, mit denen die Zeilen in der Antwort gefiltert werden. Jede Anweisung enthält ein Feld und einen Wert, die mit den eq Operatoren or ne verknüpft sind, und Anweisungen können mit and oder orkombiniert werden. Sie können die folgenden Felder angeben:partnerTenantId id Name Markt firstSubscriptionCreationDate latestSubscriptionCreationDate firstSubscriptionEndDate latestSubscriptionEndDate firstSubscriptionSuspendedDate latestSubscriptionSuspendedDate firstSubscriptionDeprovisionedDate latestSubscriptionDeprovisionedDate Beispiel: .../indirectresellers?filter=market eq 'US'Beispiel: .../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset)) |
| Aggregationsniveau | Schnur | Gibt den Zeitraum an, für den aggregierte Daten abgerufen werden sollen. Kann eine der folgenden Zeichenfolgen sein: "day", "week" oder "month". Wenn nicht angegeben, ist der Standardwert "day".aggregationLevelwird ohne .aggregationLevel
aggregationLevel gilt für alle Datumsfelder, die in der aggregationLevel |
| Sortierung nach | Schnur | Eine Anweisung, die die Ergebnisdatenwerte für jede Installation sortiert. Die Syntax ist ...&orderby=field[order],field [order],.... Der Feldparameter kann eine der folgenden Zeichenfolgen sein:"partnerTenantId" "Es" "Name" "Markt" "firstSubscriptionCreationDate" "latestSubscriptionCreationDate" "firstSubscriptionEndDate" "latestSubscriptionEndDate" "firstSubscriptionSuspendedDate" "latestSubscriptionSuspendedDate" "firstSubscriptionDeprovisionedDate" "latestSubscriptionDeprovisionedDate" "subscriptionCount" "licenseCount" Der order-Parameter ist optional und kann or desc; seinasc, um für jedes Feld eine aufsteigende oder absteigende Reihenfolge anzugeben. Der Standardwert lautet asc.Beispiel: ...&orderby=market,subscriptionCount |
| GruppierenNach | Schnur | Eine Aussage, die die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder angeben: partnerTenantId ID Name Markt firstSubscriptionCreationDate latestSubscriptionCreationDate firstSubscriptionEndDate latestSubscriptionEndDate firstSubscriptionSuspendedDate latestSubscriptionSuspendedDate firstSubscriptionDeprovisionedDate latestSubscriptionDeprovisionedDate Die zurückgegebenen Datenzeilen enthalten die in der groupby Klausel angegebenen Felder sowie die folgenden Felder:indirectResellerCount licenseCount (englisch) subscriptionCount Der groupby Parameter kann mit dem aggregationLevel Parameter verwendet werden.Beispiel: ...&groupby=ageGroup,market&aggregationLevel=week |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center REST-Header.
Anfragekörper
Keiner.
Beispielanfrage
GET https://api.partnercenter.microsoft.com/partner/v1/analytics/indirectresellers HTTP 1.1
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 Ressourcen für indirekte Vertriebspartner .
Antworterfolgs- und Fehlercodes
Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und andere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste findest du unter Fehlercodes.
Antwortbeispiel
{
"partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"id": "1111111",
"name": "RESELLER NAME",
"market": "US",
"firstSubscriptionCreationDate": "2016-10-18T19:16:25.107",
"latestSubscriptionCreationDate": "2016-10-18T19:16:25.107",
"firstSubscriptionEndDate": "2018-11-07T00:00:00",
"latestSubscriptionEndDate": "2018-11-07T00:00:00",
"firstSubscriptionSuspendedDate": "0001-01-01T00:00:00",
"latestSubscriptionSuspendedDate": "0001-01-01T00:00:00",
"firstSubscriptionDeprovisionedDate": "0001-01-01T00:00:00",
"latestSubscriptionDeprovisionedEndDate": "0001-01-01T00:00:00",
"subscriptionCount": 10,
"licenseCount": 20
}