accessReviewStage 资源类型

命名空间：microsoft.graph

重要

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

备注

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

表示 Azure AD 访问评审 重复的阶段。 如果父 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	字符串	阶段的唯一标识符。 只读。
评论家	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、InProgress、Completing、Completed和 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"
    }
  ]
}