type de ressource directoryRoleTemplate
Espace de noms: microsoft.graph
Remarque
Microsoft vous recommande d’utiliser l’API RBAC unifiée au lieu de cette API. L’API RBAC unifiée offre davantage de fonctionnalités et de flexibilité. Pour plus d’informations, consultez type de ressource unifiedRoleDefinition.
Représente un modèle de rôle d’annuaire. Un modèle de rôle d’annuaire spécifie les valeurs de propriété d’un rôle d’annuaire (directoryRole). Il existe un objet de modèle de rôle d’annuaire associé pour chacun des rôles d’annuaire qui peuvent être activés dans un locataire. Pour lire un rôle d’annuaire ou mettre à jour ses membres, vous devez d’abord l’activer dans le client. Seuls les administrateurs de l’entreprise sont activés par défaut. Pour activer d’autres rôles d’annuaire disponibles, vous envoyez une requête POST au /directoryRoles
point de terminaison avec l’ID du modèle de rôle d’annuaire sur lequel le rôle d’annuaire est basé spécifié dans le paramètre roleTemplateId de la requête. Une fois cette demande terminée, vous pouvez commencer à lire et affecter des membres au rôle d’annuaire.
Remarque : un modèle de rôle d’annuaire est exposé pour le rôle d’annuaire Utilisateurs. Le rôle d’annuaire Utilisateurs est implicite et n’est pas visible pour les clients d’annuaire. Chaque utilisateur du locataire est affecté à ce rôle par l’infrastructure. Le rôle est déjà activé. N’utilisez pas ce modèle.
Méthodes
Méthode | Type renvoyé | Description |
---|---|---|
Obtenir | directoryRoleTemplate | Lisez les propriétés et les relations de l’objet directoryRoleTemplate. |
List | collection directoryRoleTemplate | Récupérez une liste d’objets directoryRoleTemplate. |
Propriétés
Propriété | Type | Description |
---|---|---|
description | String | Description à définir pour le rôle d’annuaire. En lecture seule. |
displayName | String | Nom d’affichage à définir pour le rôle d’annuaire. En lecture seule. |
id | String | Identificateur unique pour le modèle. Hérité de directoryObject. Vous spécifiez l’id du modèle de rôle d’annuaire pour la propriété roleTemplateId dans la requête POST pour activer un élément directoryRole dans un client. Clé, ne peut pas avoir la valeur Null. En lecture seule. |
Relations
Aucun
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"description": "string",
"displayName": "string",
"id": "string (identifier)"
}