Compartir a través de


Tipo de recurso directoryRoleTemplate

Espacio de nombres: microsoft.graph

Nota:

Microsoft recomienda usar la API de RBAC unificada en lugar de esta API. La API de RBAC unificada proporciona más funcionalidad y flexibilidad. Para obtener más información, vea tipo de recurso unifiedRoleDefinition.

Representa una plantilla de rol de directorio. Una plantilla de rol de directorio especifica los valores de propiedad de un rol de directorio (directoryRole). Hay un objeto de plantilla de rol de directorio asociado para cada uno de los roles de directorio que se pueden activar en un inquilino. Para leer un rol de directorio o actualizar sus miembros, debe activarse primero en el inquilino. Solo se activa de manera predeterminada el rol de directorio Administradores de la compañía. Para activar otros roles de directorio disponibles, envíe una solicitud POST al /directoryRoles punto de conexión con el identificador de la plantilla de rol de directorio en la que se basa el rol de directorio especificado en el parámetro roleTemplateId de la solicitud. Al completar esta solicitud, puede empezar a leer y asignar miembros al rol de directorio. Nota: Una plantilla de rol de directorio se expone para el rol de directorio Usuarios. El rol de directorio Usuarios es implícito y no es visible para los clientes de directorio. La infraestructura asigna a todos los usuarios del inquilino a este rol. El rol ya está activado. No use esta plantilla.

Métodos

Método Tipo de valor devuelto Descripción
Get directoryRoleTemplate Lea las propiedades y las relaciones del objeto directoryRoleTemplate.
Lista Colección directoryRoleTemplate Recupere una lista de objetos directoryRoleTemplate.

Propiedades

Propiedad Tipo Descripción
description String La descripción del rol de directorio que se establecerá. Solo lectura.
displayName String El nombre para mostrar del rol de directorio que se establecerá. Solo lectura.
id String El identificador único de la plantilla. Hereda de directoryObject. Especifique el id de la plantilla de rol de directorio de la propiedad roleTemplateId en la solicitud POST para activar un directoryRole en un inquilino. Clave, no admite valores NULL. Solo lectura.

Relaciones

Ninguno

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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