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