accessReviewInstance 资源类型

命名空间:microsoft.graph

表示Microsoft Entra 访问评审 定期。 如果父 accessReviewScheduleDefinition 是定期访问评审,则实例表示每个重复周期。 不重复的评审将只包含一个实例。 实例还表示在计划定义中查看的每个唯一组。 如果计划定义评审多个组,则每个组将为每个重复周期提供唯一实例。

每个 accessReviewInstance 都包含审阅者可以对其执行操作的 决策 列表。 每个正在审查的标识都有一个决策。

继承自 entity

Methods

方法 返回类型 Description
List accessReviewInstance 集合 获取 accessReviewInstance 对象及其属性的列表。
Get accessReviewInstance 读取 accessReviewInstance 对象的属性和关系。
更新 accessReviewInstance 更新 accessReviewInstance 对象的审阅者。
按当前用户筛选 accessReviewInstance 集合 返回给定 accessReviewScheduleDefinition 的所有实例,调用用户是一个或多个决策的审阅者。
列出已联系的审阅者 accessReviewReviewer 集合 获取收到访问评审实例通知的审阅者。
发送提醒 None 向 accessReviewInstance 的审阅者发送提醒。
Stop None 手动停止 accessReviewInstance。
接受建议 None 允许调用用户接受每个标记为 NotReviewed 且调用方是关联 accessReviewInstance 的审阅者的 accessReviewInstionItem 的决策建议。
应用决策 None 手动对 accessReviewInstance 应用决策。
批处理记录决策 None 在一次调用中查看主体或资源的批处理。
重置决策 None 将实例上的所有决策项重置为 notReviewed
列出阶段 accessReviewStage 集合 检索多阶段访问评审实例中的阶段。
列出决策 accessReviewInstanceDecisionItem 集合 从 decisions 导航属性获取 accessReviewInstanceDecisionItem 资源。

属性

属性 类型 说明
endDateTime DateTimeOffset 计划审阅实例结束时的 DateTime。DatetimeOffset 类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $select。 只读。
fallbackReviewers accessReviewReviewerScope 集合 此审阅者范围集合用于定义回退审阅者的列表。 如果从指定的审阅者列表中找不到任何用户,将通知这些回退审阅者采取措施。 如果组所有者被指定为审阅者,但组所有者不存在,或者经理被指定为审阅者,但用户的经理不存在,则可能会发生这种情况。 支持 $select
id String 实例的唯一标识符。 支持 $select。 只读。
评论家 accessReviewReviewerScope 集合 此访问评审范围集合用于定义审阅者是谁。 支持 $select。 有关分配审阅者的选项示例,请参阅 使用 Microsoft Graph API 将审阅者分配到访问评审定义
范围 accessReviewScope 基于 accessReviewScheduleDefinition 级别的 scopeinstanceEnumerationScope 创建。 定义组中查看的用户的范围。 仅支持 $select$filter (contains) 。 此为只读属性。
startDateTime DateTimeOffset 计划启动评审实例时的 DateTime。 可能在将来。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $select。 只读。
status String 指定 accessReview 的状态。 可能的值:Initializing、、NotStartedStartingInProgressCompletingCompletedAutoReviewing、 和 AutoReviewed。 仅支持 $select$orderby$filter (eq) 。 只读。

关系

关系 类型 说明
contactedReviewers accessReviewReviewer 集合 返回已联系以完成此评审的审阅者的集合。 虽然 accessReviewScheduleDefinition审阅者和fallbackReviewers 属性可能会将组所有者或经理指定为审阅者,但 contactedReviewers 将返回其个人标识。 支持 $select。 只读。
决定 accessReviewInstanceDecisionItem 集合 在 accessReviewInstance 中审阅的每个用户都有一个决策项,表示他们是否已批准、拒绝或尚未评审。
stages accessReviewStage 集合 如果实例有多个阶段,则返回阶段的集合。 仅当上一阶段结束时,才会创建新阶段。 评审实例上阶段的存在、数量和设置基于父 accessReviewScheduleDefinition 上的 accessReviewStageSettings 创建。

JSON 表示形式

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

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "contactedReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewer"
    }
  ],
 "endDateTime": "string (timestamp)",
 "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "id": "string (identifier)",
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "startDateTime": "string (timestamp)",
  "status": "string"
  
}