Partager via


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)"
}