Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
La plateforme de gestion des licences Microsoft Cloud améliore la gestion des licences en décomposant les licences de différents abonnements en pools plus petits et gérables appelés allocations. L’association de licences à leurs abonnements uniques permet une comptabilité et des rapports plus précis pour une organization.
L’API de licence cloud est définie dans le sous-espace microsoft.graph.cloudLicensingde nom OData .
Authentification et permissions
Microsoft Graph contrôle l’accès aux ressources via les autorisations. En tant que développeur, vous devez spécifier les autorisations dont vous avez besoin pour accéder aux ressources de licences cloud. En règle générale, vous spécifiez les autorisations dans le centre d’administration Microsoft Entra. Pour plus d’informations, reportez-vous à l’article relatif aux Autorisations Microsoft Graph.
Cas d’utilisation courants
Le tableau suivant répertorie les cas d’usage courants pour l’API de licence cloud.
| Cas d’utilisation | Ressources REST |
|---|---|
| Répertorier et obtenir les droits d’utilisation | usageRight |
| Répertorier et obtenir les allocations | Allotissement |
| Créer et gérer des affectations | Affectation |
| Résoudre les erreurs de synchronisation des affectations | assignmentError |
| Répertorier et inspecter les membres en attente | waitingMember |
Détails de la conception d’API
Les sections suivantes décrivent les détails de conception de l’API de licence cloud.
Allotissements
L’entité allotment représente un pool gérable de licences associées à un abonnement. Utilisez des allocations pour suivre la capacité, les services pris en charge et les abonnements derrière ces licences.
Affectations
L’entité d’attribution représente une attribution de licence qui accorde une licence pour une allocation à un utilisateur, un appareil ou un groupe. Utilisez les API d’affectations pour créer, mettre à jour, lister et supprimer des affectations qui consomment de la capacité d’allocation.
Erreurs d’affectation
L’entité assignmentError met en évidence les échecs de synchronisation asynchrone qui affectent le traitement des affectations. Utilisez ces API pour détecter, inspecter et dépanner les affectations qui ont échoué ou sont bloquées.
Abonnements
L’entité d’abonnement contient des informations de base sur un abonnement qui prend en charge une allocation, y compris les dates et l’état du cycle de vie.
Droits d’utilisation
L’entité usageRight est conçue pour les vérifications de licence du client et de la charge de travail, avec des relations structurées pour passer de l’utilisateur ou du groupe à l’utilisationRight.
Membres en attente
L’entité waitingMember représente un utilisateur ou un appareil qui a été ajouté à la salle d’attente pour une allocation en raison de limites de capacité de licence ; il indique la durée d’attente de chaque membre.
Étapes suivantes
- Explorez les ressources et les méthodes les plus utiles à votre scénario.
- Essayez l’API de gestion des licences cloud dans le Explorer Graph.