Obtenir des informations sur le déploiement des licences

Article
09/11/2024

Comment obtenir des informations sur le déploiement pour les licences Office et Dynamics.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur.

Demande REST

Syntaxe de la requête

Méthode	URI de requête
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Paramètres URI

Paramètre	Type	Description	Obligatoire
top	string	Le nombre de lignes de données à renvoyer dans la requête. La valeur maximale et la valeur par défaut en l’absence de définition est 10000. Si la requête comporte davantage de lignes, le corps de la réponse inclut un lien sur lequel vous cliquez pour solliciter la page suivante de données.	Non
skip	int	Le nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir de grands ensembles de données. Par exemple, indiquez top=10000 et skip=0 pour obtenir les 10000 premières lignes de données, top=10000 et skip=10000 pour obtenir les 10000 lignes suivantes, et ainsi de suite.	Non
filter	chaîne	Le paramètre filter de la requête contient une ou plusieurs instructions qui filtrent les lignes de la réponse. Chaque instruction contient un champ et une valeur qui sont associés aux opérateurs ou, et les instructions peuvent être combinées à l’aide `eqand` de ou `or`.`ne` Voici quelques exemples de paramètres filter : filter=serviceCode eq 'O365' filter=serviceCode eq 'O365' ou (canal eq 'Reseller') Vous pouvez spécifier les champs suivants : serviceCode Servicename canal customerTenantId customerName productId Productname	Non
groupby	chaîne	Une instruction qui applique l’agrégation des données uniquement sur les champs spécifiés. Vous pouvez spécifier les champs suivants : serviceCode Servicename canal customerTenantId customerName productId Productname Les lignes de données retournées contiennent les champs spécifiés dans le paramètre groupby et les éléments suivants : licencesDéployées licenceSvendu	Non
processedDateTime	DateTime	Vous pouvez spécifier la date à partir de laquelle les données d’utilisation ont été traitées. Par défaut, la date la plus récente à laquelle les données ont été traitées	Non

Exemple de requête

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

Réponse REST

En cas de réussite, le corps de la réponse contient les champs suivants contenant des données sur les licences déployées.

Champ	Type	Description
serviceCode	string	Code de service
serviceName	chaîne	Nom du service
channel	chaîne	Nom du canal, revendeur
customerTenantId	chaîne	Identificateur unique pour le client
customerName	chaîne	Nom de client
productId	string	Identificateur unique pour le produit
ProductName	chaîne	Nom du produit
licencesDéployées	long	Nombre de licences déployées
licenceSvendu	long	Nombre de licences vendues
processedDateTime	DateTime	Date du dernier traitement des données

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

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
}

Partager via