unifiedRoleDefinition 资源类型
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示作为 Microsoft 365 RBAC 角色管理的一部分,列出可由 RBAC 提供程序执行的操作(如读取、写入和删除)的权限集合。
当前支持以下 RBAC 提供程序:
- 云电脑
- 设备管理 (Intune)
- 目录 (Microsoft Entra ID)
- 权利管理 (Microsoft Entra 权利管理)
- Exchange Online
方法
方法 | 返回类型 | 说明 |
---|---|---|
List roleDefinitions | unifiedRoleDefinition 集合 | 读取 unifiedRoleDefinition 对象及其属性的列表。 |
获取 unifiedRoleDefinition | unifiedRoleDefinition | 读取 unifiedRoleDefinition 对象的属性。 |
创建 roleDefinitions | unifiedRoleDefinition | 创建 unifiedRoleDefinition 对象。 |
更新 unifiedRoleDefinition | unifiedRoleDefinition | 更新 unifiedRoleDefinition 对象。 |
删除 unifiedRoleDefinition | 无 | 删除 unifiedRoleDefinition 对象。 |
列出 assignedPrincipals | directoryObject collection | 获取跨所有范围分配给角色的用户和组。 |
属性
属性 | 类型 | 说明 |
---|---|---|
allowedPrincipalTypes | allowedRolePrincipalTypes | 可分配角色的主体类型。 此为只读属性。 可能的值包括 user 、servicePrincipal 、group 、unknownFutureValue 。 这是一个多值枚举,最多可以包含三个值作为逗号分隔字符串。 例如,user, group 。 支持 $filter (eq )。 |
说明 | String | unifiedRoleDefinition 的说明。 当 isBuiltIn 为 时, true 只读。 |
displayName | String | unifiedRoleDefinition 的显示名称。 当 isBuiltIn 为 时, true 只读。 必填。 支持 $filter (eq 和 startsWith )。 |
id | 字符串 | unifiedRoleDefinition 的唯一标识符。 键,不可为 null,只读。 仅支持 $filter (eq 运算符) 。 |
isBuiltIn | 布尔值 | 指示 unifiedRoleDefinition 是产品或自定义中包含的默认集的一部分的标志。 此为只读属性。 支持 $filter (eq )。 |
isEnabled | Boolean | 指示是否为分配启用了角色的标志。 如果为 false,则角色不可用于分配。 当 isBuiltIn 为 时, true 只读。 |
isPrivileged | 布尔值 | 指示角色是否具有特权的标志。 如果角色在 rolePermissions 和 allowedResourceActions 对象中至少包含一个敏感资源操作,则Microsoft Entra ID将角色定义为特权。 仅适用于资源命名空间中的 microsoft.directory 操作。 此为只读属性。 支持 $filter (eq )。 |
resourceScopes | 字符串集合 | 角色定义授予的权限应用于的范围列表。 目前仅 / 支持。 当 isBuiltIn 为 时, true 只读。 请勿使用。 这将很快弃用。 将范围附加到角色分配. |
rolePermissions | unifiedRolePermission 集合 | 角色中包含的权限列表。 当 isBuiltIn 为 时, true 只读。 必填。 |
templateId | String | 当 isBuiltIn 为 false 时可以设置的自定义模板标识符。 如果需要不同目录中的标识符相同,则通常使用此标识符。 当 isBuiltIn 为 时, true 只读。 |
version | String | 指示 unifiedRoleDefinition 对象的版本。 当 isBuiltIn 为 时, true 只读。 |
关系
关系 | 类型 | 说明 |
---|---|---|
inheritsPermissionsFrom | unifiedRoleDefinition 集合 | 给定角色定义继承自的角色定义只读集合。 只有Microsoft Entra内置角色支持此属性。 |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"allowedPrincipalTypes": "String",
"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"
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈