accessReviewInstance 资源类型

命名空间：microsoft.graph

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

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

继承自 entity。

Methods

方法	返回类型	说明
列出 accessReviewInstances	accessReviewInstance 集合	获取 accessReviewInstance 对象及其属性的列表。
获取 accessReviewInstance	accessReviewInstance	读取 accessReviewInstance 对象的属性和关系。
更新 accessReviewInstance	accessReviewInstance	更新 accessReviewInstance 对象的审阅者。
filterByCurrentUser	accessReviewInstance 集合	返回给定 accessReviewScheduleDefinition 的所有实例，调用用户是一个或多个决策的审阅者。
列出已联系的审阅者	accessReviewReviewer 集合	获取收到访问评审实例通知的审阅者。
sendReminder	无	向 accessReviewInstance 的审阅者发送提醒。
stop	无	手动停止 accessReviewInstance。
acceptRecommendations	无	允许调用用户接受每个标记为 NotReviewed 且调用方是关联 accessReviewInstance 的审阅者的 accessReviewInstionItem 的决策建议。
applyDecisions	无	手动对 accessReviewInstance 应用决策。
batchRecordDecisions	无	在一次调用中查看主体或资源的批处理。
resetDecisions	无	将实例上的所有决策项重置为 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 图形 API将审阅者分配到访问评审定义。
范围	accessReviewScope	基于 accessReviewScheduleDefinition 级别的 scope 和 instanceEnumerationScope 创建。 定义组中查看的用户的范围。 仅支持 $select 和 $filter (contains) 。 此为只读属性。
startDateTime	DateTimeOffset	计划启动评审实例时的 DateTime。 可能在将来。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $select。 只读。
status	String	指定 accessReview 的状态。 可能的值：Initializing、、NotStarted、Starting、InProgressCompletingCompleted、AutoReviewing、 和 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"
    }
  ],
 "displayName": "string",
 "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"
  
}