Obtenir les licences attribuées à un utilisateur par groupe de licences
Comment obtenir la liste des licences attribuées par l’utilisateur pour les groupes de licences spécifiés.
Prérequis
Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.
ID du client (
customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).Identificateur d’utilisateur.
Liste d’un ou de plusieurs identificateurs de groupe de licences.
Rôles GDAP
Vous aurez besoin d’au moins l’un des rôles GDAP suivants :
- Lecteur de répertoire
- Administrateur de licence
- Administrateur d’utilisateurs
- Enregistreurs de répertoire
C#
Pour case activée quelles licences sont affectées à un utilisateur à partir de groupes de licences spécifiés, commencez par instancier un [List/dotnet/api/system.collections.generic.list-1) de type LicenseGroupId, puis ajoutez les groupes de licences à la liste. Ensuite, utilisez la méthode IAggregatePartner.Customers.ById avec l’ID client pour identifier le client. Ensuite, appelez la méthode Users.ById avec l’ID utilisateur pour identifier l’utilisateur. Ensuite, obtenez une interface pour les opérations de licence utilisateur client à partir de la propriété Licences . Enfin, passez la liste des groupes de licences à la méthode Get ou GetAsync pour récupérer la collection de licences attribuées à l’utilisateur.
// string selectedCustomerUserId;
// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// To get the group1 (Azure Active Directory (AAD)) assigned licenses.
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>(){ LicenseGroupId.Group1 };
var customerUserAadAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get(licenseGroupIds);
// To get the group2 (Minecraft) assigned licenses.
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>(){ LicenseGroupId.Group2 };
var customerUserSfbAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get(licenseGroupIds);
// To get both AAD and Minecraft assigned licenses.
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>(){ LicenseGroupId.Group1, LicenseGroupId.Group2 };
var customerUserBothAadAndSfbAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get(licenseGroupIds);
Demande REST
Syntaxe de la requête
| Méthode | URI de demande |
|---|---|
| GET | {baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses ?licenseGroupIds=Group1 HTTP/1.1 |
| GET | {baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses ?licenseGroupIds=Group2 HTTP/1.1 |
| GET | {baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses ?licenseGroupIds=Group1&licenseGroupIds=Group2 HTTP/1.1 |
Paramètre d’URI
Utilisez le chemin d’accès et les paramètres de requête suivants pour identifier le client, l’utilisateur et les groupes de licences.
| Nom | Type | Requise | Description |
|---|---|---|---|
| id-client | string | Oui | Chaîne au format GUID qui identifie le client. |
| user-id | string | Oui | Chaîne au format GUID qui identifie l’utilisateur. |
| licenseGroupIds | string | Non | Valeur d’énumération qui indique le groupe de licences des licences affectées. Valeurs valides : Group1, Group2 Group1 : ce groupe a tous les produits dont la licence peut être gérée dans l’ID Microsoft Entra. Groupe2 : ce groupe possède uniquement des licences de produit Minecraft. |
En-têtes de requête
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Corps de la demande
Aucun.
Exemple de requête
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/users/482e2152-4b49-48ec-b715-823365ce3d4c/licenses?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
Réponse REST
Si elle réussit, le corps de la réponse contient la collection de ressources de licence .
Codes d’erreur et de réussite de la réponse
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. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez les codes d’erreur de l’Espace partenaires.
Exemple de réponse
HTTP/1.1 200 OK
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST
{
"totalCount": 2,
"items": [{
"servicePlans": [
],
"productSku": {
"id": "984df360-9a74-4647-8cf8-696749f6247a",
"name": "Minecraft Education Edition Faculty",
"skuPartNumber": "CFQ7TTC0K5DR/0002",
"licenseGroupId": "group2"
},
"attributes": {
"objectType": "License"
}
}, {
"servicePlans": [{
"displayName": "Windows Defender Advanced Threat Protection",
"serviceName": "WINDEFATP",
"id": "871d91ec-ec1a-452b-a83f-bd76c7d770ef",
"capabilityStatus": "Assigned",
"targetType": "User"
}, {
"displayName": "Windows 10 Enterprise E3",
"serviceName": "WIN10_PRO_ENT_SUB",
"id": "21b439ba-a0ca-424f-a6cc-52f954a5b111",
"capabilityStatus": "Assigned",
"targetType": "User"
}
],
"productSku": {
"id": "1e7e1070-8ccb-4aca-b470-d7cb538cb07e",
"name": "Windows 10 Enterprise E5",
"skuPartNumber": "WIN_ENT_E5",
"licenseGroupId": "group1"
},
"attributes": {
"objectType": "License"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
Exemple de réponse (aucune licence correspondante trouvée)
Si aucune licence correspondante n’est disponible pour les groupes de licences spécifiés, la réponse contient une collection vide avec un élément totalCount dont la valeur est 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"
}
}
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour