Obtener las licencias asignadas a un usuarioGet licenses assigned to a user

Se aplica a:Applies to:

  • Centro de partnersPartner Center

Cómo obtener una lista de licencias asignadas a un usuario dentro de una cuenta de cliente.How to get a list of licenses assigned to a user within a customer account. Los ejemplos que se muestran aquí devuelven licencias asignadas desde Grupo1, el grupo de licencias predeterminado que representa las licencias administradas por Azure Active Directory.The examples shown here return licenses assigned from group1, the default license group that represents licenses managed by Azure Active Directory. Para obtener licencias asignadas de los grupos de licencias especificados, consulte obtener licencias asignadas a un usuario por grupo de licencias.To get licenses assigned from specified license groups, see Get licenses assigned to a user by license group.

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 solo con credenciales de aplicación y usuario.This scenario supports authentication with App+User credentials only.

  • Un id. de cliente (customer-tenant-id).A customer ID (customer-tenant-id). Si no conoces el identificador del cliente, puedes buscarlo en el panel del Centro de partners.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecciona CSP en el menú del Centro de partners, seguido de Clientes.Select CSP from the Partner Center menu, followed by Customers. En la lista de clientes, selecciona el cliente y, a continuación, elige Cuenta.Select the customer from the customer list, then select Account. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. El identificador de Microsoft es el mismo que el de cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Identificador de usuario.A user identifier.

C#C#

Para comprobar qué licencias se asignan a un usuario desde el grupo de licencias Grupo1 predeterminado, primero use el método colección iaggregatepartner. customers. ById con el identificador de cliente para identificar al cliente.To check which licenses are assigned to a user from the default group1 license group, first use the IAggregatePartner.Customers.ById method with the customer ID to identify the customer. Después, llame al método users. ById con el identificador de usuario para identificar al usuario.Then call the Users.ById method with the user ID to identify the user. A continuación, obtenga una interfaz para las operaciones de licencia de usuario de cliente desde la propiedad licenses .Next, get an interface to customer user license operations from the Licenses property. Por último, llame a los métodos Get o GetAsync para recuperar la colección de licencias asignada al usuario.Finally, call the Get or the GetAsync method to retrieve the collection of licenses assigned to the user.

// string selectedCustomerUserId;
// string selectedCustomerId;
// IAggregatePartner partnerOperations;

var customerUserAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get();

Ejemplo: aplicación de prueba de consola.Sample: Console test app. Proyecto: SDK del centro de Partners ( clase): CustomerUserAssignedLicenses.CSProject: Partner Center SDK Samples Class: CustomerUserAssignedLicenses.cs

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/customers/{customer-ID}/users/{User-ID}/licenses http/1.1{baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses HTTP/1.1

Parámetro de URIURI parameter

Use los siguientes parámetros de ruta de acceso para identificar el cliente y el usuario.Use the following path parameters to identify the customer and user.

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-idcustomer-id stringstring Yes Cadena con formato de GUID que identifica al cliente.A GUID formatted string that identifies the customer.
user-iduser-id stringstring Yes Cadena con formato de GUID que identifica al usuario.A GUID formatted string that identifies the user.

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/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/users/482e2152-4b49-48ec-b715-823365ce3d4c/licenses HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 68e50b00-e1ff-422a-a293-158617463d41
MS-CorrelationId: 813f15b3-eb18-4709-b2f3-668d62babf91
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Respuesta RESTREST response

Si se realiza correctamente, el cuerpo de respuesta contiene la colección de recursos de licencia .If successful, the response body contains the collection of License resources.

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, consulte códigos de error del centro de Partners.For the full list, see Partner Center error codes.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Length: 3883
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 813f15b3-eb18-4709-b2f3-668d62babf91
MS-RequestId: 68e50b00-e1ff-422a-a293-158617463d41
MS-CV: WYkHYMfWTUajFosK.0
MS-ServerId: 020021921
Date: Fri, 09 Jun 2017 00:29:24 GMT

{
    "totalCount": 1,
    "items": [{
            "servicePlans": [{
                    "displayName": "Azure Information Protection Premium P1",
                    "serviceName": "RMS_S_PREMIUM",
                    "id": "6c57d4b6-3b23-47a5-9bc9-69f17b4947b3",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }, {
                    "displayName": "Microsoft Intune A Direct",
                    "serviceName": "INTUNE_A",
                    "id": "c1ec4a95-1f05-45b3-a911-aa3fa01094f5",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }, {
                    "displayName": "Microsoft Azure Active Directory Rights",
                    "serviceName": "RMS_S_ENTERPRISE",
                    "id": "bea4c11e-220a-4e6d-8eb8-8ea15d019f90",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }, {
                    "displayName": "Azure Active Directory Premium P1",
                    "serviceName": "AAD_PREMIUM",
                    "id": "41781fb2-bc02-4b7c-bd55-b576c07bb09d",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }, {
                    "displayName": "Microsoft Azure Multi-Factor Authentication",
                    "serviceName": "MFA_PREMIUM",
                    "id": "8a256a2b-b617-496d-b51b-e76466e88db0",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }
            ],
            "productSku": {
                "id": "efccb6f7-5641-4e0e-bd10-b4976e1bf68e",
                "name": "Enterprise Mobility + Security E3",
                "skuPartNumber": "EMS",
                "licenseGroupId": "group1"
            },
            "attributes": {
                "objectType": "License"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}