governanceRoleAssignment 资源类型

命名空间：microsoft.graph

重要

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

警告

面向 Azure 资源的此版本特权标识管理 (PIM) API 即将弃用。 请使用新的 面向 Azure 资源角色的 Azure REST PIM API。

表示用户或组对角色的分配。

Privileged Identity Management (PIM) 支持两种类型的分配：

1. 活动分配 - 表示对资源的直接/激活访问。
2. 合格分配 - 表示在无访问权限和直接访问之间对资源的特权访问的中间阶段。 管理员可以提前将 eligible assignment 用户/组分配到 ，每当需要访问时， activation 都需要在 上 eligible assignment 获得对资源的即时访问数小时。 激活后，将为用户/组成员创建 ， active assignment 以指示激活状态。

方法

方法	返回类型	说明
Get	governanceRoleAssignment	读取角色分配实体的属性和关系。
List	governanceRoleAssignment 集合	列出资源上的角色分配集合。
Export	octet-stream	下载资源上的角色分配集合，并另存为 .csv 文件。

实体POST集不支持roleAssignments任何 、PUT、 PATCH或 DELETE 操作。 上 governanceRoleAssignment 的任何创建、更新和删除操作都由 governanceRoleAssignmentRequest完成。

属性

属性	类型	说明
id	String	角色分配的 ID。 它采用 GUID 格式。
resourceId	String	必填。 与角色分配关联的资源的 ID。
roleDefinitionId	String	必填。 与角色分配关联的角色定义 ID。
subjectId	String	必填。 与角色分配关联的主题的 ID。
linkedEligibleRoleAssignmentId	String	如果这是 ， active assignment 并且由于 在 上 eligible assignment激活而创建，则表示该 eligible assignment的 ID;否则，值为 null。
externalId	String	用于标识提供程序中角色分配的资源的外部 ID。
startDateTime	DateTimeOffset	角色分配的开始时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
endDateTime	DateTimeOffset	对于非永久角色分配，这是角色分配过期的时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
assignmentState	String	工作分配的状态。 该值可以是 Eligible 符合条件的分配，也可以 Active 是管理员直接分配 Active 的，也可以是用户对符合条件的分配激活的值。
memberType	String	成员的类型。 该值可以是： Inherited (如果角色分配继承自父资源范围) ， Group (如果角色分配不是继承的，而是来自组分配) 的成员身份，或者 User (角色分配未继承或从组分配) 。

关系

关系	类型	说明
资源	governanceResource	此为只读属性。 与角色分配关联的资源。
roleDefinition	governanceRoleDefinition	此为只读属性。 与角色分配关联的角色定义。
subject	governanceSubject	此为只读属性。 与角色分配关联的主题。
linkedEligibleRoleAssignment	governanceRoleAssignment	此为只读属性。 如果这是 ， active assignment 并且由于在 上 eligible assignment激活而创建，则表示 的 eligible assignment对象;否则，值为 null。

JSON 表示形式

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

{
  "id": "String (identifier)",
  "resourceId": "String",
  "roleDefinitionId": "String",
  "subjectId": "String",
  "linkedEligibleRoleAssignmentId": "String",
  "externalId": "String",
  "startDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "assignmentState": "String",
  "memberType": "String",
}