Obtener la información de implementación de licencias de usuarioGet customer licenses deployment information

Se aplica aApplies To

  • Centro de partnersPartner Center

Cómo obtener información sobre la implementación de licencias para un cliente específico.How to get licenses deployment insights for a specific customer.

Nota

Este escenario se ha sustituido por obtener información de implementación de licencias.This scenario is superceded by Get licenses deployment information.

Requisitos previosPrerequisites

Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario admite la autenticación con credenciales de aplicación y usuario.This scenario supports authentication with App+User credentials.

C#C#

Para recuperar datos agregados en la implementación de un cliente especificado, llame primero al método colección iaggregatepartner. customers. ById con el identificador de cliente para identificar al cliente.To retrieve aggregated data on deployment for a specified customer, first call the IAggregatePartner.Customers.ById method with the customer ID to identify the customer. A continuación, obtenga una interfaz para las operaciones de recopilación de análisis de nivel de cliente desde la propiedad Analytics .Then get an interface to customer level analytics collection operations from the Analytics property. A continuación, recupere una interfaz a la colección de análisis de licencias de nivel de cliente desde la propiedad licenses .Next, retrieve an interface to the customer level licenses analytics collection from the Licenses property. Por último, llame al método Deployment. Get para obtener los datos agregados en la implementación de licencias.Finally, call the Deployment.Get method to get the aggregated data on licenses deployment. Si el método se ejecuta correctamente, obtendrá una colección de objetos CustomerLicensesDeploymentInsights .If the method succeeds you'll get a collection of CustomerLicensesDeploymentInsights objects.

// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;

var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Deployment.Get();

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/customers/{customer-ID}/Analytics/licenses/Deployment http/1.1{baseURL}/v1/customers/{customer-id}/analytics/licenses/deployment HTTP/1.1

Parámetro de URIURI parameter

Use el siguiente parámetro de ruta de acceso para identificar al cliente.Use the following path parameter to identify the customer.

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-idcustomer-id guidguid Yes Identificador de cliente con formato GUID que identifica al cliente.A GUID formatted customer-id that identifies the customer.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest example

GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/analytics/licenses/deployment HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b01b8759-4dbe-4605-adb7-e5839a796c33
MS-CorrelationId: ae3b8c36-348b-46bc-9a60-398f973153ff
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Respuesta RESTREST response

Si se realiza correctamente, el cuerpo de respuesta contiene una colección de recursos CustomerLicensesDeploymentInsights que proporcionan información acerca de las licencias implementadas.If successful, the response body contains a collection of CustomerLicensesDeploymentInsights resources that provide information about the licenses deployed.

Códigos de error y de respuesta correctosResponse success and error codes

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.For the full list, see Partner Center REST error codes.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Length: 1012
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ae3b8c36-348b-46bc-9a60-398f973153ff
MS-RequestId: b01b8759-4dbe-4605-adb7-e5839a796c33
MS-CV: deEp2Wy6DUitMCYA.0
MS-ServerId: 102030524
Date: Wed, 15 Mar 2017 01:19:18 GMT

{
    "totalCount": 3,
    "items": [{
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "OFFICE 365 BUSINESS ESSENTIALS",
            "licensesDeployed": 0,
            "deploymentPercent": 0.0,
            "licensesSold": 1,
            "processedDateTime": "2017-03-14T03:25:16.36+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesDeploymentInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "EXCHANGE ONLINE (PLAN 1)",
            "licensesDeployed": 0,
            "deploymentPercent": 0.0,
            "licensesSold": 5,
            "processedDateTime": "2017-03-14T03:25:16.36+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesDeploymentInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "EXCHANGE ONLINE ARCHIVING FOR EXCHANGE ONLINE",
            "licensesDeployed": 0,
            "deploymentPercent": 0.0,
            "licensesSold": 2,
            "processedDateTime": "2017-03-14T03:25:16.36+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesDeploymentInsights"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}