unifiedRoleAssignmentMultiple 资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

unifiedRoleAssignmentMultiple 用于授予对资源的访问权限,作为Microsoft 365 基于角色的访问控制 (RBAC) 的一部分。 它表示分配给主体数组的角色定义, (用户通常通过范围数组) 。

可以创建具有多个主体和多个作用域的角色分配。

必须提供 directoryScopeIds 或 appScopeIds。

当前支持以下 RBAC 提供程序:

  • 云电脑
  • Microsoft Intune

方法

方法 返回类型 Description
List unifiedRoleAssignmentMultiple 集合 读取 unifiedRoleAssignmentMultiple 对象及其属性的列表。
创建 unifiedRoleAssignmentMultiple 通过发布到 roleAssignment 集合来创建新的 unifiedRoleAssignmentMultiple。
Get unifiedRoleAssignmentMultiple 读取 unifiedRoleAssignmentMultiple 对象的属性和关系。
更新 unifiedRoleAssignmentMultiple 更新现有的 unifiedRoleAssignmentMultiple 对象。
删除 无 删除 unifiedRoleAssignmentMultiple 对象。

属性

属性 类型 说明
appScopeIds 字符串集合 分配范围特定于应用的范围的 ID。 分配的范围决定了主体有权访问的资源集。 目录范围是存储在目录中的共享范围,可由多个应用程序理解。 用于 / 租户范围。 应用范围是仅此应用程序定义和理解的范围。
说明 String 角色分配的说明。
directoryScopeIds 字符串集合 表示分配范围的目录对象的 ID。 分配的范围决定了向其授予主体访问权限的资源集。 目录范围是存储在目录中的共享范围,可由多个应用程序理解。 应用范围是仅此应用程序定义和理解的范围。
displayName String 角色分配的名称。 必需。
id String unifiedRoleAssignmentMultiple 对象的唯一标识符。 键,不可为 null,只读。
principalIds 字符串集合 向其授予分配的主体的标识符。 仅支持 $filter (any 运算符) 。
roleDefinitionId String 分配所针对的 unifiedRoleDefinition 的标识符。

关系

关系 类型 说明
appScopes appScope 集合 当分配范围特定于应用时,包含特定于应用的范围的详细信息的只读集合。 包含实体。 此为只读属性。
directoryScopes directoryObject collection 引用属于分配范围的目录对象的只读集合。 提供,以便调用方可以在获取角色分配的同时使用 $expand 获取目录对象。 只读。 支持 $expand。
校长 directoryObject collection 引用分配的主体的只读集合。 提供,以便调用方可以在获取角色分配的同时使用 $expand 获取主体。 只读。 支持 $expand。
roleDefinition unifiedRoleDefinition 指定分配的 roleDefinition 。 提供,以便调用方可以在获取角色分配的同时使用 $expand 获取角色定义。 支持 id、isBuiltIn 和 displayName 上的 (eq 运算符,在 startsWithdisplayName 上支持$filter运算符) 和 $expand。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "appScopeIds": ["string"],
  "appScopes": [{"@odata.type": "microsoft.graph.appScope"}],
  "description": "String",
  "directoryScopeIds": ["String"],
  "directoryScopes": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "displayName": "String",
  "id": "String (identifier)",
  "principalIds": ["String"],
  "principals": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "roleDefinition": {"@odata.type": "microsoft.graph.unifiedRoleDefinition"},
  "roleDefinitionId": "String"
}