unifiedRoleAssignmentScheduleRequest 资源类型

命名空间：microsoft.graph

在 PIM 中，表示对主体进行活动角色分配的请求。 角色分配可以在到期日期或未过期日期的情况下永久活动，也可以在激活符合条件的分配后暂时处于活动状态。 继承自 请求。

有关可通过 unifiedRoleAssignmentScheduleRequest 资源类型定义的 PIM 方案的详细信息，请参阅 通过特权标识管理 (PIM) API 进行角色管理的概述。

方法

方法	返回类型	说明
列出 unifiedRoleAssignmentScheduleRequests	unifiedRoleAssignmentScheduleRequest 集合	检索通过 unifiedRoleAssignmentScheduleRequest 对象进行的活动角色分配的请求。
创建 unifiedRoleAssignmentScheduleRequest	unifiedRoleAssignmentScheduleRequest	为活动和持久角色分配创建请求，或者激活、停用、扩展或续订符合条件的角色分配。
获取 unifiedRoleAssignmentScheduleRequest	unifiedRoleAssignmentScheduleRequest	检索通过 unifiedRoleAssignmentScheduleRequest 对象进行的活动角色分配的请求。
取消	无	取消对活动角色分配的请求。
filterByCurrentUser	unifiedRoleAssignmentScheduleRequest 集合	检索针对特定主体的活动角色分配的请求。

属性

属性	类型	说明
action	String	表示角色分配请求上的操作类型。 可取值包括：adminAssign、adminUpdate、adminRemove、selfActivate、selfDeactivate、adminExtend、adminRenew、selfExtend、selfRenew、unknownFutureValue。 adminAssign：让管理员将角色分配给主体。 adminRemove：让管理员从角色中删除主体。 adminUpdate：让管理员更改现有角色分配。 adminExtend：让管理员延长即将过期的分配。 adminRenew：让管理员续订过期的分配。 selfActivate：让主体激活其分配。 selfDeactivate：让主体停用其活动分配。 selfExtend：让主体请求延长其即将过期的分配。 selfRenew：让主体请求续订其过期的分配。
approvalId	String	请求批准的标识符。 继承自 请求。
appScopeId	String	分配作用域为应用时特定于应用的范围的标识符。 分配的范围确定已授予主体访问权限的资源集。 应用范围是仅由此应用程序定义和理解的范围。 用于 / 租户范围的应用范围。 使用 directoryScopeId 将范围限制为特定目录对象，例如管理单元。 支持$filter (eq和ne``null值) 。
completedDateTime	DateTimeOffset	请求完成日期时间。 继承自 请求。
createdBy	identitySet	创建此请求的主体。 继承自 请求。 只读。 支持$filter (eq和ne``null值) 。
createdDateTime	DateTimeOffset	请求创建日期时间。 继承自 请求。 只读。
customData	String	用于定义请求的任何自定义数据的免费文本字段。 未使用。 继承自 请求。
directoryScopeId	String	表示分配范围的目录对象的标识符。 分配的范围确定已授予主体访问权限的资源集。 目录范围是存储在多个应用程序理解的目录中的共享范围。 用于 / 租户范围。 使用 appScopeId 将范围限制为仅限应用程序。 支持$filter (eq和ne``null值) 。
id	String	unifiedRoleAssignmentScheduleRequest 对象的唯一标识符。 键，不可为 null，只读。 继承自 entity。 支持 $filter（eq、ne）。
isValidationOnly	Boolean	确定调用是验证还是实际调用。 仅当要在实际提交请求之前检查激活是否受 MFA 等其他规则约束时，才设置此属性。
理由	String	用户和管理员创建 unifiedRoleAssignmentScheduleRequest 对象时提供的消息。
principalId	String	已授予分配的主体的标识符。 支持 $filter（eq、ne）。
roleDefinitionId	String	分配给主体的 unifiedRoleDefinition 对象的标识符。 支持 $filter（eq、ne）。
scheduleInfo	requestSchedule	角色分配的周期。 当前不支持定期计划。
status	String	角色分配请求的状态。 继承自 请求。 只读。 支持 $filter（eq、ne）。
targetScheduleId	String	链接到分配请求的计划对象的标识符。 支持 $filter（eq、ne）。
ticketInfo	ticketInfo	链接到角色分配请求的票证详细信息，包括票证编号和票证系统的详细信息。

关系

关系	类型	说明
activatedUsing	unifiedRoleEligibilitySchedule	如果请求来自符合条件的管理员来激活角色，则此参数将显示该激活的相关合格分配。 否则，它是 null. 支持 $expand。
appScope	appScope	当分配范围限定到应用时，具有特定于应用范围的详细信息的只读属性。 可为 NULL。 支持 $expand。
directoryScope	directoryObject	作为分配范围的目录对象。 只读。 支持 $expand。
主要	directoryObject	通过请求获取角色分配的主体。 支持 $expand。
roleDefinition	unifiedRoleDefinition	通过 roleDefinitionId 属性引用的 unifiedRoleDefinition 对象的详细信息。 支持 $expand。
targetSchedule	unifiedRoleAssignmentSchedule	通过 targetScheduleId 属性引用的符合条件的角色分配的计划。 支持 $expand。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.unifiedRoleAssignmentScheduleRequest",
  "id": "String (identifier)",
  "status": "String",
  "completedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "approvalId": "String",
  "customData": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "action": "String",
  "principalId": "String",
  "roleDefinitionId": "String",
  "directoryScopeId": "String",
  "appScopeId": "String",
  "isValidationOnly": "Boolean",
  "targetScheduleId": "String",
  "justification": "String",
  "scheduleInfo": {
    "@odata.type": "microsoft.graph.requestSchedule"
  },
  "ticketInfo": {
    "@odata.type": "microsoft.graph.ticketInfo"
  }
}