Obter informações de implantação de licenças

Artigo
09/11/2024

Como obter informações de implantação para licenças do Office e do Dynamics.

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte à autenticação com credenciais de aplicativo + usuário.

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Parâmetros do URI

Parâmetro	Type	Descrição	Obrigatório
top	string	O número de linhas de dados a serem retornadas na solicitação. O valor máximo e o valor padrão; se não forem especificados, será 10.000. Se houver mais linhas na consulta, o corpo da resposta incluirá um link que você poderá usar para solicitar a próxima página de dados.	Não
skip	INT	O número de linhas a serem ignoradas na consulta. Use este parâmetro para percorrer grandes conjuntos de dados. Por exemplo, top=10000 e skip=0 recuperam as primeiras 10.000 linhas de dados, top=10000 e skip=10000 recuperam as próximas 10.000 linhas de dados e assim por diante.	Não
filter	string	O parâmetro filter da solicitação contém uma ou mais instruções que filtram as linhas da resposta. Cada instrução contém um campo e um valor associados aos `eq` operadores ou `ne` e instruções podem ser combinadas usando `and` ou `or`. Estes são alguns exemplos dos parâmetros filter: filter=serviceCode eq 'O365' filter=serviceCode eq 'O365' ou (channel eq 'Reseller') Você pode especificar os campos a seguir: serviceCode Servicename canal customerTenantId Customername productId Productname	Não
groupby	string	Uma instrução que aplica a agregação de dados apenas aos campos especificados. Você pode especificar os campos a seguir: serviceCode Servicename canal customerTenantId Customername productId Productname As linhas de dados retornadas conterão os campos especificados no parâmetro groupby e o seguinte: licensesDeployed licensesSold	Não
processedDateTime	Datetime	É possível especificar a data da qual os dados de uso foram processados. O padrão é a data mais recente quando os dados foram processados	Não

Exemplo de solicitação

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

Resposta REST

Se tiver êxito, o corpo da resposta conterá os campos a seguir que contêm dados sobre as licenças implantadas.

Campo	Type	Descrição
serviceCode	string	Código de serviço
serviceName	string	Nome do serviço
channel	string	Nome do canal, revendedor
customerTenantId	string	Identificador exclusivo para o cliente
customerName	string	Nome do cliente
productId	string	Identificador exclusivo para o produto
productName	string	Nome do produto
licensesDeployed	long	Número de licenças implantadas
licensesSold	long	Número de licenças vendidas
processedDateTime	Datetime	Data em que os dados foram processados pela última vez

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de erro REST do Partner Center.

Exemplo de resposta

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
}

Compartilhar via