Ottenere informazioni sulla distribuzione delle licenze

Articolo
09/11/2024

Come ottenere informazioni sulla distribuzione per le licenze di Office e Dynamics.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali dell'app e dell'utente.

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Parametri URI

Parametro	Tipo	Descrizione	Obbligatoria
top	string	Numero di righe di dati da restituire nella richiesta. Il valore massimo e il valore predefinito se non specificato è 10000. Se nella query sono presenti più righe, il corpo della risposta include un link successivo che puoi usare per richiedere la pagina successiva dei dati.	No
skip	INT	Numero di righe da ignorare nella query. Usa questo parametro per scorrere set di dati di grandi dimensioni. Ad esempio, top=10000 e skip=0 recupera le prime 10000 righe di dati, top=10000 e skip=10000 recupera le 10000 righe successive e così via.	No
filter	string	Il parametro filter della richiesta include una o più istruzioni per filtrare le righe nella risposta. Ogni istruzione contiene un campo e un valore associati agli `eq` operatori o `ne` e le istruzioni possono essere combinate usando `and` o `or`. Ecco alcuni esempi di parametri filter: filter=serviceCode eq 'O365' filter=serviceCode eq 'O365' o (canale eq 'Reseller') Puoi specificare i campi seguenti: serviceCode Servicename Canale customerTenantId customerName Productid Productname	No
groupby	string	Istruzione che applica l'aggregazione dei dati solo ai campi specificati. Puoi specificare i campi seguenti: serviceCode Servicename Canale customerTenantId customerName Productid Productname Le righe di dati restituite conterranno i campi specificati nel parametro groupby e i seguenti: licensesDeployed licenzeSold	No
processedDateTime	Datetime	È possibile specificare la data da cui sono stati elaborati i dati di utilizzo. Impostazione predefinita alla data più recente in cui i dati sono stati elaborati	No

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/commercial/deployment/license?filter=customerTenantId%20eq%20%27aaaabbbb-0000-cccc-1111-dddd2222eeee%27 HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Risposta REST

Se ha esito positivo, il corpo della risposta contiene i campi seguenti contenenti dati sulle licenze distribuite.

Campo	Tipo	Descrizione
serviceCode	string	Codice di servizio
serviceName	string	Nome del servizio
channel	string	Nome canale, rivenditore
customerTenantId	string	Identificatore univoco per il cliente
customerName	string	Nome cliente
productId	string	Identificatore univoco per il prodotto
productName	string	Nome prodotto
licensesDeployed	long	Numero di licenze distribuite
licenzeSold	long	Numero di licenze vendute
processedDateTime	Datetime	Data dell'ultima elaborazione dei dati

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempio di risposta

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "customerName": "TEST COMPANY",
      "productId": "D3B4FE1F-9992-4930-8ACB-CA6EC609365E",
      "productName": "DOMESTIC AND INTERNATIONAL CALLING PLAN",
      "licensesDeployed": 0,
      "licensesSold": 5
    }
],
  "@nextLink": null,
  "TotalCount": 2
}

Condividi tramite