accessReviewInstance 资源类型

命名空间：microsoft.graph

重要

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

注意

这是建议用于访问评审的 API。 以前版本的 访问评审 API 已弃用。

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

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

方法

方法	返回类型	说明
列出 accessReviewInstances	accessReviewInstance 集合	获取 accessReviewInstance 对象及其属性的列表。
获取 accessReviewInstance	accessReviewInstance	读取 accessReviewInstance 对象的属性和关系。
更新 accessReviewInstance	accessReviewInstance	更新 accessReviewInstance 对象的审阅者。
filterByCurrentUser	accessReviewInstance 集合	返回给定 accessReviewScheduleDefinition 上的所有实例，调用用户是一个或多个决策的审阅者。
列出已联系的审阅者	accessReviewReviewer 集合	获取收到访问评审实例通知的审阅者。
sendReminder	无。	向 accessReviewInstance 的审阅者发送提醒。
stop	无。	手动停止 accessReviewInstance。
acceptRecommendations	无。	允许调用用户接受作为特定 accessReviewInstance 审阅者的每个 NotReviewed accessReviewInstanceDecisionItem 的决策建议。
applyDecisions	无。	手动对 accessReviewInstance 应用决策。
stopApplyDecisions	无。	允许调用用户停止对特定 accessReviewInstance 的应用决策操作。
batchRecordDecisions	无	在一次调用中查看主体或资源的批处理。
resetDecisions	无	将实例上的所有决策项重置为 notReviewed。
列出阶段	accessReviewStage 集合	检索多阶段访问评审实例中的阶段。
列出决策	accessReviewInstanceDecisionItem 集合	从 decisions 导航属性获取 accessReviewInstanceDecisionItem 资源。
列出 pendingAccessReviewInstances (已弃用)	accessReviewInstance 集合。	获取分配给调用用户的所有挂起 accessReviewInstance 资源。 此方法已弃用，并替换为 filterByCurrentUser。

属性

属性	类型	说明
endDateTime	DateTimeOffset	计划审阅实例结束时的 DateTime。 DatetimeOffset 类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $select。 只读。
错误	accessReviewError 集合	访问评审实例生命周期中的错误集合。 此为只读属性。
fallbackReviewers	accessReviewReviewerScope 集合	此审阅者范围集合用于定义回退审阅者的列表。 如果从指定的审阅者列表中找不到任何用户，系统会通知这些回退审阅者采取措施。 如果组所有者被指定为审阅者，但组所有者不存在，或者经理被指定为审阅者，但用户的经理不存在，则可能会发生这种情况。 支持 $select。
id	String	实例的唯一标识符。 支持 $select。 只读。
范围	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) 。 此为只读属性。
评论家	accessReviewReviewerScope 集合	此访问评审范围集合用于定义审阅者是谁。 支持 $select。 有关分配审阅者的选项示例，请参阅使用 Microsoft 图形 API将审阅者分配到访问评审定义。

关系

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

JSON 表示形式

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

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