unifiedRoleEligibilityScheduleRequest 资源类型

命名空间:microsoft.graph

表示通过 PIM 请求主体的角色资格。 角色资格可以永久符合条件,没有到期日期,也可以暂时有资格使用到期日期。 继承自 请求

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

注意

若要激活符合条件的角色分配,请使用 创建 unifiedRoleAssignmentScheduleRequest API。

方法

方法 返回类型 Description
List unifiedRoleEligibilityScheduleRequest 集合 检索通过 unifiedRoleEligibilityScheduleRequest 对象对主体的角色资格请求。
创建 unifiedRoleEligibilityScheduleRequest 通过 unifiedRoleEligibilityScheduleRequest 对象请求主体的角色资格。
Get unifiedRoleEligibilityScheduleRequest 阅读通过 unifiedRoleEligibilityScheduleRequest 对象发出的角色资格请求请求的详细信息。
按当前用户筛选 unifiedRoleEligibilityScheduleRequest 集合 在 PIM 中,检索特定主体的角色资格请求。 主体可以是 unifiedRoleEligibilityScheduleRequest 对象的创建者或审批者,也可以是角色资格的目标。
Cancel None 立即取消状态为 GrantedunifiedRoleEligibilityScheduleRequest 对象,并让系统在 30 天后自动删除已取消的请求。

属性

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

关系

关系 类型 说明
appScope appScope 当角色资格限定为应用时,具有特定于应用范围的详细信息的只读属性。 可为 NULL。 支持 $expand
directoryScope directoryObject 作为角色资格范围的目录对象。 只读。 支持 $expand
主要 directoryObject 通过请求获取角色资格的主体。 支持 $expand
roleDefinition unifiedRoleDefinition 通过 roleDefinitionId 属性引用的 unifiedRoleDefinition 对象的详细信息。 支持 $expand
targetSchedule unifiedRoleEligibilitySchedule 通过 targetScheduleId 属性引用的角色资格计划。 支持 $expand

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.unifiedRoleEligibilityScheduleRequest",
  "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"
  }
}