accessReviewStage 资源类型

命名空间：microsoft.graph

重要

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

注意

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

表示Microsoft Entra访问评审定期的阶段。 如果父 accessReviewScheduleDefinition 定义了 stageSettings 属性， 则 accessReviewInstance 最多由三个后续阶段组成。 每个阶段可以有一组不同的审阅者，他们可以处理阶段决策，并设置确定哪些决策在阶段之间传递。

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

方法

方法	返回类型	说明
列出 accessReviewStages	accessReviewStage 集合	获取 accessReviewStage 对象及其属性的列表。
获取 accessReviewStage	accessReviewStage	读取 accessReviewStage 对象的属性和关系。
更新 accessReviewStage	accessReviewStage	更新 accessReviewStage 对象的属性。
stop	无	手动停止 accessReviewStage。
filterByCurrentUser	accessReviewStage 集合	返回给定 accessReviewInstance 上调用用户为其审阅者的所有阶段。
列出决策	accessReviewInstanceDecisionItem 集合	获取 accessReviewStage 中做出的决策。

属性

属性	类型	说明
endDateTime	DateTimeOffset	安排评审阶段结束时的 DateTime。 DatetimeOffset 类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 此属性是所有阶段的 持续时间的 累计总和。 此为只读属性。
fallbackReviewers	accessReviewReviewerScope 集合	此审阅者范围集合用于定义回退审阅者的列表。 如果从指定的审阅者列表中找不到任何用户，系统会通知这些回退审阅者采取措施。 如果组所有者被指定为审阅者，但组所有者不存在，或者管理员被指定为审阅者，但用户的经理不存在，则可能会发生这种情况。
id	String	阶段的唯一标识符。 此为只读属性。
评论家	accessReviewReviewerScope 集合	此访问评审范围集合用于定义审阅者是谁。 有关分配审阅者的选项示例，请参阅使用 Microsoft 图形 API将审阅者分配到访问评审定义。
startDateTime	DateTimeOffset	安排评审阶段开始时的 DateTime。 可能在将来。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
status	String	指定 accessReviewStage 的状态。 可能的值：Initializing、、NotStarted、Starting、InProgressCompletingCompleted、AutoReviewing、 和 AutoReviewed。 仅支持 $orderby、 和 $filter (eq) 。 只读。

关系

关系	类型	说明
决定	accessReviewInstanceDecisionItem 集合	在 accessReviewStage 中审阅的每个用户都有一个决策项，表示他们是否已批准、拒绝或尚未评审。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.accessReviewStage",
  "id": "String (identifier)",
  "startDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "status": "String",
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ]
}