Alle analysegegevens van indirecte resellers ophalen

  • Artikel

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government

Informatie over het ophalen van alle analysegegevens van indirecte resellers voor uw klanten.

Vereisten

  • Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met alleen gebruikersreferenties.

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

URI-parameters

Parameter Type Beschrijving
partnerTenantId tekenreeks De tenant-id van de partner waarvoor u gegevens van indirecte resellers wilt ophalen.
id tekenreeks Indirecte reseller-id
naam tekenreeks De naam van de partner waarvoor u gegevens van indirecte resellers wilt ophalen.
markt tekenreeks De markt van de partner waarvoor u indirecte resellersgegevens wilt ophalen.
firstSubscriptionCreationDate tekenreeks in UTC-datum/tijdnotatie De aanmaakdatum van het eerste abonnement op basis waarvan u gegevens van indirecte resellers wilt ophalen.
latestSubscriptionCreationDate tekenreeks in UTC-datum/tijdnotatie De aanmaakdatum van het nieuwste abonnement.
firstSubscriptionEndDate tekenreeks in UTC-datum/tijdnotatie De eerste keer dat een abonnement is beëindigd.
latestSubscriptionEndDate tekenreeks in UTC-datum/tijdnotatie Laatste datum waarop een abonnement is beëindigd.
firstSubscriptionSuspendedDate tekenreeks in UTC-datum/tijd De eerste keer dat een abonnement is onderbroken.
latestSubscriptionSuspendedDate tekenreeks in UTC-datum/tijdnotatie Laatste datum waarop een abonnement is onderbroken.
firstSubscriptionDeprovisionedDate tekenreeks in UTC-datum/tijdnotatie De eerste keer dat de inrichting van een abonnement is ongedaan gemaakt.
latestSubscriptionDeprovisionedDate tekenreeks in UTC-datum/tijdnotatie Laatste datum waarop de inrichting van een abonnement is ongedaan gemaakt.
subscriptionCount double Aantal abonnementen voor alle resellers met toegevoegde waarde
licenseCount double Aantal licenties voor alle resellers met toegevoegde waarde.
indirectResellerCount double Aantal indirecte resellers
top tekenreeks Het aantal rijen met gegevens dat in de aanvraag moet worden geretourneerd. De maximumwaarde en de standaardwaarde als deze niet is opgegeven, is 10000. Als de query meer rijen bevat, bevat de antwoordtekst een volgende koppeling die u kunt gebruiken om de volgende pagina met gegevens op te vragen.
skip int Het aantal rijen dat in de query moet worden overgeslagen. Gebruik deze parameter om grote gegevenssets te doorlopen. Haalt bijvoorbeeld top=10000 and skip=0 de eerste 10000 rijen met gegevens op, top=10000 and skip=10000 haalt de volgende 10000 rijen met gegevens op, enzovoort.
filter tekenreeks De filterparameter van de aanvraag bevat een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke instructie bevat een veld en waarde die zijn gekoppeld aan de eq operatoren of ne , en -instructies kunnen worden gecombineerd met of andor. U kunt de volgende velden opgeven:

partnerTenantId
id
Naam
markt
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Voorbeeld:
.../indirectresellers?filter=market eq 'US'

Voorbeeld:
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregationLevel tekenreeks Hiermee geeft u het tijdsbereik op waarvoor geaggregeerde gegevens moeten worden opgehaald. Kan een van de volgende tekenreeksen zijn: 'day', 'week' of 'month'. Indien niet opgegeven, is de standaardwaarde 'dag'.

aggregationLevel wordt niet ondersteund zonder een aggregationLevel. aggregationLevel is van toepassing op alle datumvelden die aanwezig zijn in de aggregationLevel
Orderby tekenreeks Een instructie waarmee de resultaatgegevenswaarden voor elke installatie worden besteld. De syntaxis is ...&orderby=field[order],field [order],.... De veldparameter kan een van de volgende tekenreeksen zijn:

"partnerTenantId"
"id"
"naam"
"markt"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"subscriptionCount"
"licenseCount"

De orderparameter is optioneel en kan of desczijn asc om een oplopende of aflopende volgorde op te geven voor elk veld. De standaardwaarde is asc.

Voorbeeld:
...&orderby=market,subscriptionCount
groupby tekenreeks Een instructie waarmee gegevensaggregatie alleen wordt toegepast op de opgegeven velden. U kunt de volgende velden opgeven:

partnerTenantId
id
Naam
markt
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de groupby component en de volgende velden:

indirectResellerCount
licenseCount
subscriptionCount

De groupby parameter kan worden gebruikt met de aggregationLevel parameter .

Voorbeeld:
...&groupby=ageGroup,market&aggregationLevel=week

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

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-antwoord

Als dit lukt, bevat de antwoordtekst een verzameling indirecte resellers-resources .

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Voorbeeld van antwoord

{
    "partnerTenantId": "AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE",
    "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
}

Zie ook