Delen via

Alle analysegegevens van indirecte resellers ophalen

  • Artikel

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Hoe u alle analysegegevens van indirecte resellers voor uw klanten kunt ophalen.

Vereisten

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

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameters

Parameter Type Description
partnerTenantId tekenreeks De tenant-id van de partner waarvoor u indirecte resellers-gegevens 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 resellers-gegevens wilt ophalen.
firstSubscriptionCreationDate tekenreeks in utc-datum/tijdnotatie De aanmaakdatum van het eerste abonnement op basis waarvan u de gegevens van indirecte resellers wilt ophalen.
latestSubscriptionCreationDate tekenreeks in utc-datum/tijdnotatie De aanmaakdatum van het meest recente 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-datumtijd 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 een abonnement ongedaan is gemaakt, is de inrichting ongedaan gemaakt.
latestSubscriptionDeprovisionedDate tekenreeks in utc-datum/tijdnotatie De laatste datum waarop een abonnement ongedaan is gemaakt.
subscriptionCount dubbel Aantal abonnementen voor alle toegevoegde waarde-resellers
licenseCount dubbel Aantal licenties voor alle toegevoegde waarde resellers.
indirectResellerCount dubbel Aantal indirecte resellers
top tekenreeks Het aantal rijen met gegevens dat moet worden geretourneerd in de aanvraag. De maximumwaarde en de standaardwaarde als deze niet zijn opgegeven, is 10.000. Als er meer rijen in de query staan, bevat de hoofdtekst van het antwoord een volgende koppeling die u kunt gebruiken om de volgende pagina met gegevens aan te vragen.
skip int Het aantal rijen dat moet worden overgeslagen in de query. Gebruik deze parameter om door grote gegevenssets te bladeren. Haalt bijvoorbeeld top=10000 and skip=0 de eerste 10.000 rijen met gegevens op, top=10000 and skip=10000 haalt de volgende 10.000 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 of ne operators, en instructies kunnen worden gecombineerd met oforand. 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. Dit kan een van de volgende tekenreeksen zijn: 'day', 'week' of 'month'. Als dit niet is opgegeven, is de standaardwaarde 'dag'.

aggregationLevel wordt niet ondersteund zonder een aggregationLevel. aggregationLevel 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 zijn asc of desc; om voor elk veld op te geven in oplopende of aflopende volgorde. De standaardwaarde is asc.

Voorbeeld:
...&orderby=market,subscriptionCount
groupby tekenreeks Een instructie die alleen gegevensaggregatie toepast 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 in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

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 antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en andere informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

{
    "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