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

Artigo
09/11/2024

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

Pré-requisitos

Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação com credenciais de Aplicação+Utilizador.

Pedido REST

Sintaxe do pedido

Método	URI do pedido
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Parâmetros URI

Parâmetro	Tipo	Descrição	Obrigatório
top	string	O número de linhas de dados a devolver no pedido. O valor máximo e o valor predefinido se não for especificado são 10000. Se existirem mais linhas na consulta, o corpo da resposta inclui uma ligação seguinte que pode utilizar para pedir a página seguinte de dados.	Não
ignorar	int	O número de linhas a ignorar na consulta. Utilize este parâmetro para página através de conjuntos de dados grandes. Por exemplo, top=10000 e skip=0 obtém as primeiras 10000 linhas de dados, top=10000 e skip=10000 obtém as próximas 10000 linhas de dados, etc.	Não
filter	string	O parâmetro de filtro do pedido contém uma ou mais instruções que filtram as linhas na resposta. Cada instrução contém um campo e um valor que estão associados aos `eq` operadores ou `ne` e as instruções podem ser combinadas com `and` ou `or`. Seguem-se alguns parâmetros de filtro de exemplo: filter=serviceCode eq "O365" filter=serviceCode eq 'O365' ou (channel eq 'Reseller') Pode especificar os seguintes campos: 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. Pode especificar os seguintes campos: serviceCode serviceName canal customerTenantId customerName productId productName As linhas de dados devolvidas conterão os campos especificados no parâmetro groupby e o seguinte: licensesDeployed licensesSold	Não
processedDateTime	DateTime	Pode-se especificar a data a partir da qual os dados de utilização foram processados. Predefinição para a data mais recente quando os dados foram processados	Não

Exemplo de pedido

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 do REST

Se for bem-sucedido, o corpo da resposta contém os seguintes campos que contêm dados sobre as licenças implementadas.

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

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de erro REST do Centro de Parceiros.

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
}

Partilhar via