tipo de recurso unifiedRoleDefinition

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