Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa una colección de permisos que enumeran las operaciones, como lectura, escritura y eliminación, que puede realizar un proveedor de RBAC como parte de la administración del rol RBAC de Microsoft 365.
Actualmente se admiten los siguientes proveedores de RBAC:
- PC en la nube.
- administración de dispositivos (Intune)
- directorio (Microsoft Entra ID)
- administración de derechos (Microsoft Entra Entitlement Management)
- Exchange en línea
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| List | colección unifiedRoleDefinition | Lea una lista de objetos unifiedRoleDefinition y sus propiedades. |
| Crear | unifiedRoleDefinition | Crea un objeto unifiedRoleDefinition. |
| Obtener | unifiedRoleDefinition | Lea las propiedades de un objeto unifiedRoleDefinition activo o eliminado de forma temporal. |
| Actualizar | unifiedRoleDefinition | Actualizar un objeto unifiedRoleDefinition. |
| Delete | Ninguno | Eliminar un objeto unifiedRoleDefinition activo o eliminar permanentemente una definición de rol personalizada eliminada temporalmente. |
| Restaurar | unifiedRoleDefinition | Restaurar una definición de rol personalizado eliminada temporalmente. |
| Enumerar entidades de seguridad asignadas | Colección directoryObject | Obtenga los usuarios y grupos asignados a un rol en todos los ámbitos. |
Propiedades
| Propiedad | Tipo | Description |
|---|---|---|
| allowedPrincipalTypes | allowedRolePrincipalTypes | Tipos de entidades de seguridad a las que se puede asignar el rol. Solo lectura. Los valores posibles son: user, servicePrincipal, group y unknownFutureValue Se trata de una enumeración de varios valores que puede contener hasta tres valores como una cadena separada por comas. Por ejemplo, user, group. Admite $filter (eq). |
| deletedDateTime | DateTimeOffset | La fecha y hora en que se eliminó la definición de rol personalizado. El valor es null para definiciones de roles activos y restaurados. Solo lectura. |
| description | Cadena | La descripción de unifiedRoleDefinition. Solo lectura cuando isBuiltIn es true. |
| displayName | Cadena | El nombre para mostrar de unifiedRoleDefinition. Solo lectura cuando isBuiltIn es true. Obligatorio. Admite $filter (eq y startsWith). |
| id | Cadena | El identificador único de unifiedRoleDefinition. Clave, no nula, solo lectura. Admite $filter (eq solo operador). |
| isBuiltIn | Booleano | Marca que indica si unifiedRoleDefinition forma parte del conjunto predeterminado incluido con el producto o personalizado. Solo lectura. Admite $filter (eq). |
| isEnabled | Boolean | Marca que indica si el rol está habilitado para la asignación. Si es falso, el rol no está disponible para su asignación. Solo lectura cuando isBuiltIn es true. |
| isPrivileged | Booleano | Marca que indica si el rol tiene privilegios. Microsoft Entra ID define un rol como privilegiado si contiene al menos una acción de recurso confidencial en los objetos rolePermissions y allowedResourceActions. Solo se aplica a las acciones del espacio de nombres de microsoft.directory recursos. Solo lectura. Admite $filter (eq). |
| resourceScopes | Colección string | Lista de ámbitos a los que se aplican los permisos concedidos por la definición de rol. Actualmente solo / se admite. Solo lectura cuando isBuiltIn es true. NO LO USES. Esto quedará en desuso pronto. Asociar ámbito a asignación de roles. |
| rolePermissions | Recopilación de unifiedRolePermission | Lista de permisos incluidos en el rol. Solo lectura cuando isBuiltIn es true. Obligatorio. |
| templateId | Cadena | Identificador de plantilla personalizado que se puede establecer cuando isBuiltIn es false. Este identificador se suele usar si se necesita que un identificador sea el mismo en directorios diferentes. Solo lectura cuando isBuiltIn es true. |
| version | Cadena | Indica la versión del objeto unifiedRoleDefinition. Solo lectura cuando isBuiltIn es true. |
Relaciones
| Relación | Tipo | Description |
|---|---|---|
| inheritsPermissionsFrom | colección unifiedRoleDefinition | Colección de solo lectura de definiciones de roles de las que hereda la definición de rol especificada. Solo los roles integrados de Microsoft Entra admiten este atributo. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"allowedPrincipalTypes": "String",
"deletedDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"id": "String (identifier)",
"isBuiltIn": true,
"isEnabled": true,
"isPrivileged": true,
"resourceScopes": ["String"],
"rolePermissions": [{"@odata.type": "microsoft.graph.unifiedRolePermission"}],
"templateId": "String",
"inheritsPermissionsFrom": [{"@odata.type": "microsoft.graph.unifiedRoleDefinition"}],
"version": "String"
}