Obtener una lista de licencias disponibles según el grupo de licencias
Cómo obtener una lista de licencias para los grupos de licencias especificados disponibles para los usuarios del cliente especificado.
Requisitos previos
Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.
Un id. de cliente (
customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).Lista de uno o varios identificadores de grupo de licencias.
Roles de GDAP
Necesitará al menos uno de los siguientes roles de GDAP:
- Lector del directorio
- Lector global
C#
Para obtener una lista de licencias disponibles para los grupos de licencias especificados, empiece creando una instancia de una lista de tipo LicenseGroupId y agregue los grupos de licencias a la lista. A continuación, use el método IAggregatePartner.Customers.ById con el identificador de cliente para identificar al cliente. A continuación, obtenga el valor de la propiedad SubscribedSkus para recuperar una interfaz para las operaciones de recopilación de SKU suscritas por el cliente. Por último, pase la lista de grupos de licencias al método Get o GetAsync para recuperar la lista de SKU suscritas con detalles sobre las unidades de licencia disponibles.
// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// To get subscribed SKUs available for group1, the license group for Azure Active Directory (AAD).
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>() { LicenseGroupId.Group1};
var customerUserAadSubscribedSkus = partnerOperations.Customers.ById(selectedCustomerId).SubscribedSkus.Get(licenseGroupIds);
// To get subscribed SKUs available for group2, the license group for Minecraft product licenses.
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>() { LicenseGroupId.Group2};
var customerUserSfbSubscribedSkus = partnerOperations.Customers.ById(selectedCustomerId).SubscribedSkus.Get(licenseGroupIds);
// To get both AAD and Minecraft subscribed SKUs.
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>() { LicenseGroupId.Group1, LicenseGroupId.Group2};
var customerUserBothAadAndSfbSubscribedSkus = partnerOperations.Customers.ById(selectedCustomerId).SubscribedSkus.Get(licenseGroupIds);
Solicitud REST
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| GET | {baseURL}/v1/customers/{customer-id}/subscribedskus?licenseGroupIds=Group1 HTTP/1.1 |
| GET | {baseURL}/v1/customers/{customer-id}/subscribedskus?licenseGroupIds=Group2 HTTP/1.1 |
| GET | {baseURL}/v1/customers/{customer-id}/subscribedskus?licenseGroupIds=Group1&licenseGroupIds=Group2 HTTP/1.1 |
Parámetro de URI
Use la siguiente ruta de acceso y parámetros de consulta para identificar el cliente y los grupos de licencias.
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| customer-id | string | Sí | Cadena con formato GUID que identifica al cliente. |
| licenseGroupIds | string | No | Valor de enumeración que indica el grupo de licencias de las licencias asignadas. Valores válidos: Group1, Group2 Group1: este grupo tiene todos los productos cuya licencia se puede administrar en el identificador de Entra de Microsoft. Group2: este grupo solo tiene licencias de productos de Minecraft. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de la solicitud
Ninguno.
Ejemplo de solicitud
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscribedskus?licenseGroupIds=Group1&licenseGroupIds=Group2 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: a1d077e4-28b1-4578-b873-6d1a82fa1644
MS-CorrelationId: c8cb5a60-ae08-4afc-92f0-efc42adfa186
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Respuesta REST
Si se ejecuta correctamente, el cuerpo de la respuesta contiene una colección de recursos SubscribedSku .
Códigos de error y de respuesta correctos
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. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error del Centro de partners.
Ejemplo de respuesta
HTTP/1.1 200 OK
Content-Length: 4328
Content-Type: application/json; charset=utf-8
MS-CorrelationId: c8cb5a60-ae08-4afc-92f0-efc42adfa186
MS-RequestId: a1d077e4-28b1-4578-b873-6d1a82fa1644
MS-CV: S6Pd5XQAx0Ss/zQi.0
MS-ServerId: 030011719
Date: Sat, 10 Jun 2017 00:19:44 GMT
{
"totalCount": 04,
"items": [{
"availableUnits": 15,
"activeUnits": 15,
"consumedUnits": 0,
"suspendedUnits": 0,
"totalUnits": 15,
"warningUnits": 0,
"productSku": {
"id": "078d2b04-f1bd-4111-bbd4-b4b1b354cef4",
"name": "Azure Active Directory Premium P1",
"skuPartNumber": "AAD_PREMIUM",
"targetType": "User",
"licenseGroupId": "group1"
},
"servicePlans": [{
"displayName": "Exchange Foundation",
"serviceName": "EXCHANGE_S_FOUNDATION",
"id": "113feb6c-3fe4-4440-bddc-54d774bf0318",
"capabilityStatus": "Enabled",
"targetType": "Tenant"
}, {
"displayName": "Azure Active Directory Premium P1",
"serviceName": "AAD_PREMIUM",
"id": "41781fb2-bc02-4b7c-bd55-b576c07bb09d",
"capabilityStatus": "Enabled",
"targetType": "User"
}, {
"displayName": "Microsoft Azure Multifactor Authentication",
"serviceName": "MFA_PREMIUM",
"id": "8a256a2b-b617-496d-b51b-e76466e88db0",
"capabilityStatus": "Enabled",
"targetType": "User"
}
],
"capabilityStatus": "Enabled",
"attributes": {
"objectType": "SubscribedSku"
}
}, {
"availableUnits": 1,
"activeUnits": 1,
"consumedUnits": 0,
"suspendedUnits": 0,
"totalUnits": 1,
"warningUnits": 0,
"productSku": {
"id": "54b84594-9c77-4499-8d65-5e0d5f410e78",
"name": "Dynamics AX Task",
"skuPartNumber": "AX_TASK_USER",
"targetType": "User",
"licenseGroupId": "group1"
},
"servicePlans": [
],
"capabilityStatus": "Enabled",
"attributes": {
"objectType": "SubscribedSku"
}
}, {
"availableUnits": 23,
"activeUnits": 72,
"consumedUnits": 49,
"suspendedUnits": 0,
"totalUnits": 72,
"warningUnits": 0,
"productSku": {
"id": "984df360-9a74-4647-8cf8-696749f6247a",
"name": "Minecraft Education Edition Faculty",
"skuPartNumber": "CFQ7TTC0K5DR/0002",
"targetType": "User",
"licenseGroupId": "group2"
},
"servicePlans": [
],
"capabilityStatus": "Enabled",
"attributes": {
"objectType": "SubscribedSku"
}
}, {
"availableUnits": 71,
"activeUnits": 112,
"consumedUnits": 41,
"suspendedUnits": 0,
"totalUnits": 112,
"warningUnits": 0,
"productSku": {
"id": "1e7e1070-8ccb-4aca-b470-d7cb538cb07e",
"name": "Windows 10 Enterprise E5",
"skuPartNumber": "WIN_ENT_E5",
"targetType": "User",
"licenseGroupId": "group1"
},
"servicePlans": [{
"displayName": "Windows Defender Advanced Threat Protection",
"serviceName": "WINDEFATP",
"id": "871d91ec-ec1a-452b-a83f-bd76c7d770ef",
"capabilityStatus": "Enabled",
"targetType": "User"
}, {
"displayName": "Windows 10 Enterprise E3",
"serviceName": "WIN10_PRO_ENT_SUB",
"id": "21b439ba-a0ca-424f-a6cc-52f954a5b111",
"capabilityStatus": "Enabled",
"targetType": "User"
}
],
"capabilityStatus": "Enabled",
"attributes": {
"objectType": "SubscribedSku"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
Ejemplo de respuesta (no se encontraron SKU coincidentes)
Si no se puede encontrar ninguna SKU suscrita coincidente para los grupos de licencias especificados, la respuesta contiene una colección vacía con un elemento totalCount cuyo valor es 0.
HTTP/1.1 200 OK
Content-Length: 71
Content-Type: application/json; charset=utf-8
MS-CorrelationId: c8cb5a60-ae08-4afc-92f0-efc42adfa186
MS-RequestId: a1d077e4-28b1-4578-b873-6d1a82fa1644
MS-CV: q05xrhUeDUKvhrFt.0
MS-ServerId: 030020525
Date: Fri, 09 Jun 2017 22:50:11 GMT
{
"totalCount": 0,
"items": [],
"attributes": {
"objectType": "Collection"
}
}
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de