Tipo de recurso directoryRoledirectoryRole resource type

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Representa un rol de directorio de Azure AD.Represents an Azure AD directory role. Los roles de directorio de Azure AD también se conocen como roles de administrador.Azure AD directory roles are also known as administrator roles. Para obtener más información sobre los roles de directorio (administrador), consulte Asignación de roles de administrador en Azure Active Directory.For more information about directory (administrator) roles, see Assigning administrator roles in Azure AD. Con Microsoft Graph, puede asignar usuarios a roles de directorio para concederles los permisos del rol de destino.With the Microsoft Graph, you can assign users to directory roles to grant them the permissions of the target role. Para leer un rol de directorio o actualizar sus miembros, debe activarse primero en el inquilino.To read a directory role or update its members, it must first be activated in the tenant. Solo se activa de manera predeterminada el rol de directorio Administradores de la compañía.Only the Company Administrators directory role is activated by default. Para activar otros roles de directorio disponibles, envíe una solicitud POST con el identificador de la directoryRoleTemplate en la que se basa el rol de directorio.To activate other available directory roles you send a POST request with the ID of the directoryRoleTemplate on which the directory role is based. Mostrar plantillas de rol de directorio para obtener todos los roles de directorio disponibles.List directory role templates to get all the other available directory roles. Se hereda de directoryObject.Inherits from directoryObject.

Este recurso admite:This resource supports:

  • El uso de una consulta delta para realizar un seguimiento de adiciones, eliminaciones y actualizaciones incrementales al proporcionar una función delta.Using delta query to track incremental additions, deletions, and updates, by providing a delta function.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Obtener directoryRoleGet directoryRole directoryRoledirectoryRole Lea las propiedades y las relaciones del objeto directoryRole.Read properties and relationships of directoryRole object.
List directoryRolesList directoryRoles Colección directoryRoledirectoryRole collection Enumera los roles de directorio que están activados en el inquilino.List the directory roles that are activated in the tenant.
Agregar miembroAdd member directoryObjectdirectoryObject Agregue un usuario al rol de directorio; para ello, publique en la propiedad de navegación de miembros.Add a user to the directory role by posting to the members navigation property.
Enumerar miembrosList members Colección directoryObjectdirectoryObject collection Obtenga los usuarios que son miembros del rol de directorio de la propiedad de navegación de miembros.Get the users that are members of the directory role from the members navigation property.
Quitar un miembroRemove a member directoryObjectdirectoryObject Elimine un usuario del rol de directorio.Remove a user from the directory role.
Activar directoryRoleActivate directoryRole directoryRoledirectoryRole Activa un rol del directorio.Activate a directory role.
deltadelta colección directoryRoledirectoryRole collection Obtiene los cambios incrementales de roles de directorio.Get incremental changes for directory roles.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
descriptiondescription StringString La descripción del rol de directorio. Solo lectura.The description for the directory role. Read-only.
displayNamedisplayName StringString El nombre para mostrar del rol de directorio. Solo lectura.The display name for the directory role. Read-only.
idid StringString El identificador único del rol de directorio. Hereda de directoryObject. Clave, no admite valores NULL, solo lectura.The unique identifier for the directory role. Inherited from directoryObject. Key, Not nullable, Read-only.
roleTemplateIdroleTemplateId StringString El id de la directoryRoleTemplate en que se basa este rol. La propiedad debe especificarse al activar un rol de directorio en un inquilino con una operación POST. Una vez activado el rol de directorio, la propiedad es de solo lectura.The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
membersmembers Colección directoryObjectdirectoryObject collection Usuarios que son miembros de este rol de directorio. Métodos HTTP: GET, POST, DELETE. Solo lectura. Admite valores NULL.Users that are members of this directory role. HTTP Methods: GET, POST, DELETE. Read-only. Nullable.

Representación JSONJSON representation

Aquí tiene una representación JSON del recursoHere is a JSON representation of the resource

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)",
  "roleTemplateId": "string"
}