Hämta information om licensdistribution

Så här hämtar du distributionsinformation för Office- och Dynamics-licenser.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med app+användarautentiseringsuppgifter.

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

URI-parametrar

Parameter	Typ	Beskrivning	Krävs
top	sträng	Antalet rader med data som ska returneras i begäran. Maxvärdet och standardvärdet om det inte anges är 10000. Om det finns fler rader i frågan innehåller svarstexten en nästa länk som du kan använda för att begära nästa sida med data.	No
hoppa över	int	Antalet rader som ska hoppas över i frågan. Använd den här parametern för att bläddra igenom stora datamängder. Till exempel hämtar top=10000 och skip=0 de första 1 0000 raderna med data, top=10000 och skip=10000 hämtar de kommande 1 0000 raderna med data och så vidare.	No
filter	sträng	Filterparametern för begäran innehåller en eller flera instruktioner som filtrerar raderna i svaret. Varje instruktion innehåller ett fält och ett värde som är associerade med operatorerna eq eller och -instruktioner kan kombineras med eller andorne . Här följer några exempel på filterparametrar: filter=serviceCode eq 'O365' filter=serviceCode eq 'O365' or (channel eq 'Reseller') Du kan ange följande fält: serviceCode Tjänstnamn Kanal customerTenantId customerName Produktionen Productname	No
groupby	sträng	En instruktion som endast tillämpar dataaggregering på de angivna fälten. Du kan ange följande fält: serviceCode Tjänstnamn Kanal customerTenantId customerName Produktionen Productname De returnerade dataraderna innehåller de fält som anges i parametern groupby och följande: licensesDeployed licensesSold	No
processedDateTime	DateTime	Man kan ange det datum då användningsdata bearbetades. Standardvärdet är det senaste datumet då data bearbetades	No

Exempel på begäran

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

Om åtgärden lyckas innehåller svarstexten följande fält som innehåller data om de distribuerade licenserna.

Fält	Typ	Description
serviceCode	sträng	Tjänstkod
Tjänstnamn	sträng	Tjänstnamn
Kanal	sträng	Kanalnamn, återförsäljare
customerTenantId	sträng	Unik identifierare för kunden
customerName	sträng	Kundnamn
productId	sträng	Unik identifierare för produkten
Productname	sträng	Produktnamn
licensesDeployed	long	Antal distribuerade licenser
licensesSold	long	Antal sålda licenser
processedDateTime	DateTime	Datum då data senast bearbetades

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.

Exempel på svar

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
}