Obtenir des informations sur le déploiement des licences partenaireGet partner licenses deployment information

S’applique àApplies To

  • Espace partenairesPartner Center

Comment faire en sorte que les informations de déploiement des licences partenaires soient agrégées pour inclure tous les clients.How to get partner licenses deployment information aggregated to include all customers.

Notes

Ce scénario est remplacé par les informations de déploiement de licences d’extraction.This scenario is superceded by Get licenses deployment information.

PrérequisPrerequisites

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur.This scenario supports authentication with App+User credentials.

C#C#

Pour récupérer des données agrégées sur le déploiement de licences, commencez par obtenir une interface pour les opérations de collection d’analyse de niveau partenaire à partir de la propriété collection iaggregatepartner. Analytics .To retrieve aggregated data on licenses deployment, first get an interface to partner level analytics collection operations from the IAggregatePartner.Analytics property. Ensuite, récupérez une interface vers la collection d’analyse des licences de niveau partenaire à partir de la propriété licenses .Then retrieve an interface to the partner level licenses analytics collection from the Licenses property. Enfin, appelez la méthode Deployment. obten pour récupérer les données agrégées sur le déploiement de licences.Finally, call the Deployment.Get method to get the aggregated data on licenses deployment. Si la méthode est réussie, vous obtenez une collection d’objets PartnerLicensesDeploymentInsights .If the method succeeds you'll get a collection of PartnerLicensesDeploymentInsights objects.

// IAggregatePartner partnerOperations;

var partnerLicensesDeploymentAnalytics = partnerOperations.Analytics.Licenses.Deployment.Get();

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET {baseURL}/v1/Analytics/licenses/Deployment http/1.1{baseURL}/v1/analytics/licenses/deployment HTTP/1.1

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Aucun.None.

Exemple de requêteRequest example

GET https://api.partnercenter.microsoft.com/v1/analytics/licenses/deployment HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 25b6edd5-1f53-456b-b48c-c64f60ec2dda
MS-CorrelationId: 6492b9d6-5629-429b-934c-040b1946e760
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Réponse RESTREST response

En cas de réussite, le corps de la réponse contient une collection de ressources PartnerLicensesDeploymentInsights qui fournissent des informations sur les licences déployées.If successful, the response body contains a collection of PartnerLicensesDeploymentInsights resources that provide information about the licenses deployed.

Codes d’erreur et de réussite de la réponseResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.For the full list, see Partner Center REST error codes.

Exemple de réponseResponse example

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6492b9d6-5629-429b-934c-040b1946e760
MS-RequestId: 25b6edd5-1f53-456b-b48c-c64f60ec2dda
MS-CV: f0trvmq8mEScHcFS.0
MS-ServerId: 102030524
Date: Tue, 14 Mar 2017 17:55:01 GMT

{
    "totalCount": 2,
    "items": [{
            "proratedDeploymentPercent": 0.0,
            "licensesSold": 343,
            "processedDateTime": "2017-03-10T00:00:00+00:00",
            "serviceName": "crm",
            "channel": "reseller",
            "attributes": {
                "objectType": "PartnerLicensesDeploymentInsights"
            }
        }, {
            "proratedDeploymentPercent": 1.0,
            "licensesSold": 4464,
            "processedDateTime": "2017-03-14T03:25:16.36+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "PartnerLicensesDeploymentInsights"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}