Obtener la información de uso de licencias de clienteGet customer licenses usage 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 sustituye por la información de uso de obtener licencias.This scenario is superceded by Get licenses usage 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/dotnet/API/Microsoft.Store.partnercenter.customers.icustomercollection.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/dotnet/api/microsoft.store.partnercenter.customers.icustomercollection.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/dotnet/API/Microsoft.Store.partnercenter.customers.icustomer.Analytics).Then get an interface to customer level analytics collection operations from the [Analytics/dotnet/api/microsoft.store.partnercenter.customers.icustomer.analytics) property. A continuación, recupere una interfaz para la colección de análisis de licencias de nivel de cliente desde la propiedad [licenses/dotnet/API/Microsoft.Store.partnercenter.Analytics.icustomeranalyticscollection.licenses).Next, retrieve an interface to the customer level licenses analytics collection from the [Licenses/dotnet/api/microsoft.store.partnercenter.analytics.icustomeranalyticscollection.licenses) property. Por último, llame al método [Usage. Get/dotnet/API/Microsoft.Store.partnercenter.genericoperations.ientireentitycollectionretrievaloperations-2.Get) para obtener los datos agregados sobre el uso de licencias.Finally, call the [Usage.Get/dotnet/api/microsoft.store.partnercenter.genericoperations.ientireentitycollectionretrievaloperations-2.get) method to get the aggregated data on licenses usage. Si el método se ejecuta correctamente, obtendrá una colección de objetos [CustomerLicensesUsageInsights/dotnet/API/Microsoft.Store.partnercenter.Models.Analytics.customerlicensesusageinsights).If the method succeeds you'll get a collection of [CustomerLicensesUsageInsights/dotnet/api/microsoft.store.partnercenter.models.analytics.customerlicensesusageinsights) objects.

// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;

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

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/customers/{customer-ID}/Analytics/licenses/Usage http/1.1{baseURL}/v1/customers/{customer-id}/analytics/licenses/usage 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/usage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: f657d2a8-9ed6-41b4-abfc-3cf4abebd62f
MS-CorrelationId: ae3b8c36-348b-46bc-9a60-398f973153ff
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com

Respuesta RESTREST response

Si se realiza correctamente, el cuerpo de respuesta contiene una colección de recursos CustomerLicensesUsageInsights que proporcionan información sobre el uso de licencias.If successful, the response body contains a collection of CustomerLicensesUsageInsights resources that provide information about licenses usage.

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: 1726
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ae3b8c36-348b-46bc-9a60-398f973153ff
MS-RequestId: f657d2a8-9ed6-41b4-abfc-3cf4abebd62f
MS-CV: 0mufM0K1kEOoR7oI.0
MS-ServerId: 030020525
Date: Wed, 15 Mar 2017 01:19:58 GMT

{
    "totalCount": 5,
    "items": [{
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "OFFICE 365 BUSINESS ESSENTIALS",
            "licensesActive": 0,
            "licensesQualified": 1,
            "usagePercent": 0.0,
            "workloadName": "Exchange",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "OFFICE 365 BUSINESS ESSENTIALS",
            "licensesActive": 0,
            "licensesQualified": 1,
            "usagePercent": 0.0,
            "workloadName": "SharePoint",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "OFFICE 365 BUSINESS ESSENTIALS",
            "licensesActive": 0,
            "licensesQualified": 1,
            "usagePercent": 0.0,
            "workloadName": "Skype For Business",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "EXCHANGE ONLINE (PLAN 1)",
            "licensesActive": 0,
            "licensesQualified": 5,
            "usagePercent": 0.0,
            "workloadName": "Exchange",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "EXCHANGE ONLINE ARCHIVING FOR EXCHANGE ONLINE",
            "licensesActive": 0,
            "licensesQualified": 2,
            "usagePercent": 0.0,
            "workloadName": "Exchange",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}