Implementatiegegevens van licenties ophalen

Informatie over de implementatie van Office en Dynamics-licenties.

Vereisten

Referenties zoals beschreven in Partner Center verificatie. Dit scenario ondersteunt verificatie met app- en gebruikersreferenties.

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
TOEVOEGEN {baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

Aanvraagheaders

Zie REST-headers Partner Center meer informatie.

URI-parameters

Parameter Type Beschrijving Vereist
top tekenreeks Het aantal rijen met gegevens dat in de aanvraag moet worden retourneren. De maximumwaarde en de standaardwaarde als deze niet is opgegeven, is 10.000. Als er meer rijen in de query staan, bevat de hoofdpagina van het antwoord een volgende koppeling die u kunt gebruiken om de volgende pagina met gegevens aan te vragen. No
skip int Het aantal rijen dat moet worden overgeslagen in de query. Gebruik deze parameter om grote gegevenssets te bekijken. Top=10000 en skip=0 haalt bijvoorbeeld de eerste 10000 rijen met gegevens op, top=10000 en skip=10000 haalt de volgende 10000 rijen met gegevens op, bijvoorbeeld. No
filter tekenreeks De filterparameter van de aanvraag bevat een of meer instructies die de rijen in het antwoord filteren. Elke instructie bevat een veld en waarde die zijn gekoppeld aan eq de operators of ne en instructies kunnen worden gecombineerd met of andor. Hier volgen enkele voorbeeldfilterparameters :

filter=serviceCode eq 'O365'
filter=serviceCode eq 'O365' of (kanaal eq 'Reseller')

U kunt de volgende velden opgeven:

serviceCode
Servicenaam
Kanaal
customerTenantId
customerName
Productid
Productnaam
No
groupby tekenreeks Een instructie die gegevensaggregatie alleen op de opgegeven velden van toepassing is. U kunt de volgende velden opgeven:

serviceCode
Servicenaam
Kanaal
customerTenantId
customerName
Productid
Productnaam

De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de groupby-parameter en het volgende:

licenties Geïmplementeerd
licentiesVerkocht
No
processedDateTime DateTime U kunt de datum opgeven vanaf welke gebruiksgegevens zijn verwerkt. De standaardwaarde is de laatste datum waarop de gegevens zijn verwerkt No

Voorbeeld van aanvraag

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/commercial/deployment/license?filter=customerTenantId%20eq%20%270112A436-B14E-4888-967B-CA4BB2CF1234%27 HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CorrelationId: 9cbdf63c-2608-4ad8-b0a9-abae27d859d9
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-antwoord

Als dit lukt, bevat de antwoord-body de volgende velden met gegevens over de geïmplementeerde licenties.

Veld Type Description
serviceCode tekenreeks Servicecode
Servicenaam tekenreeks Servicenaam
Kanaal tekenreeks Kanaalnaam, reseller
customerTenantId tekenreeks Unieke id voor de klant
customerName tekenreeks Klantnaam
productId tekenreeks Unieke id voor het product
Productnaam tekenreeks Productnaam
licenties Geïmplementeerd long Aantal geïmplementeerde licenties
licentiesVerkocht long Aantal verkochte licenties
processedDateTime DateTime De datum waarop de gegevens voor het laatst zijn verwerkt

Antwoord geslaagd en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of de fout is geslaagd en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerk traceren om deze code, het fouttype en aanvullende parameters te lezen. Zie REST-foutcodes voor Partner Center lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 9cbdf63c-2608-4ad8-b0a9-abae27d859d9
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CV: f0trvmq8mEScHcFS.0
MS-ServerId: 4
Date: Wed, 24 Oct 2018 22:37:18 GMT
{
  "Value": [

{
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "crm",
      "serviceName": "Microsoft Dynamics",
      "channel": "reseller",
      "customerTenantId": "0112A436-B14E-4888-967B-CA4BB2CF1234",
      "customerName": "TEST COMPANY",
      "productId": "54B84594-9C77-4499-8D65-5E0D5F410E78",
      "productName": "DYNAMICS AX TASK",
      "licensesDeployed": 0,
      "licensesSold": 9
    },
    {
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "o365",
      "serviceName": "Microsoft Office 365",
      "channel": "reseller",
      "customerTenantId": "0112A436-B14E-4888-967B-CA4BB2CF1234",
      "customerName": "TEST COMPANY",
      "productId": "D3B4FE1F-9992-4930-8ACB-CA6EC609365E",
      "productName": "DOMESTIC AND INTERNATIONAL CALLING PLAN",
      "licensesDeployed": 0,
      "licensesSold": 5
    }
],
  "@nextLink": null,
  "TotalCount": 2
}