accessReviewInstance 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
注意
这是建议用于访问评审的 API。 以前版本的 访问评审 API 已弃用。
表示Microsoft Entra 访问评审 定期。 如果父 accessReviewScheduleDefinition 是定期访问评审，则实例表示每个重复周期。 不重复的评审将正好包含一个实例。 实例还表示在计划定义中查看的每个唯一组。 如果计划定义评审多个组，则每个组对每个重复周期都有一个唯一实例。
每个 accessReviewInstance 都包含审阅者可以对其执行操作的 决策 列表。 每个正在审查的标识都有一个决策。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | accessReviewInstance 集合 | 获取 accessReviewInstance 对象及其属性的列表。 |
| Get | accessReviewInstance | 读取 accessReviewInstance 对象的属性和关系。 |
| 更新 | accessReviewInstance | 更新 accessReviewInstance 对象的审阅者。 |
| 按当前用户筛选 | accessReviewInstance 集合 | 返回给定 accessReviewScheduleDefinition 上的所有实例，调用用户是一个或多个决策的审阅者。 |
| 列出已联系的审阅者 | accessReviewReviewer 集合 | 获取收到访问评审实例通知的审阅者。 |
| 发送提醒 | 无。 | 向 accessReviewInstance 的审阅者发送提醒。 |
| Stop | 无。 | 手动停止 accessReviewInstance。 |
| 接受建议 | 无。 | 允许调用用户接受作为特定 accessReviewInstance 审阅者的每个 NotReviewed accessReviewInstanceDecisionItem 的决策建议。 |
| 应用决策 | 无。 | 手动对 accessReviewInstance 应用决策。 |
| 停止应用决策 | 无。 | 允许调用用户停止对特定 accessReviewInstance 的应用决策操作。 |
| 批处理记录决策 | None | 在一次调用中查看主体或资源的批处理。 |
| 重置决策 | None | 将实例上的所有决策项重置为 notReviewed。 |
| 列出阶段 | accessReviewStage 集合 | 检索多阶段访问评审实例中的阶段。 |
| 列出决策 | accessReviewInstanceDecisionItem 集合 | 从 decisions 导航属性获取 accessReviewInstanceDecisionItem 资源。 |
| 列出挂起的访问评审实例 (弃用) | 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 Graph 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)",
"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"
}
]
}