accessReviewInstance 资源类型
命名空间：microsoft.graph
表示Microsoft Entra 访问评审 定期。 如果父 accessReviewScheduleDefinition 是定期访问评审，则实例表示每个重复周期。 不重复的评审将只包含一个实例。 实例还表示在计划定义中查看的每个唯一组。 如果计划定义评审多个组，则每个组将为每个重复周期提供唯一实例。
每个 accessReviewInstance 都包含审阅者可以对其执行操作的 决策 列表。 每个正在审查的标识都有一个决策。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | accessReviewInstance 集合 | 获取 accessReviewInstance 对象及其属性的列表。 |
| Get | accessReviewInstance | 读取 accessReviewInstance 对象的属性和关系。 |
| 更新 | accessReviewInstance | 更新 accessReviewInstance 对象的审阅者。 |
| 按当前用户筛选 | accessReviewInstance 集合 | 返回给定 accessReviewScheduleDefinition 的所有实例，调用用户是一个或多个决策的审阅者。 |
| 列出已联系的审阅者 | accessReviewReviewer 集合 | 获取收到访问评审实例通知的审阅者。 |
| 发送提醒 | None | 向 accessReviewInstance 的审阅者发送提醒。 |
| Stop | None | 手动停止 accessReviewInstance。 |
| 接受建议 | None | 允许调用用户接受每个标记为 NotReviewed 且调用方是关联 accessReviewInstance 的审阅者的 accessReviewInstionItem 的决策建议。 |
| 应用决策 | None | 手动对 accessReviewInstance 应用决策。 |
| 批处理记录决策 | None | 在一次调用中查看主体或资源的批处理。 |
| 重置决策 | None | 将实例上的所有决策项重置为 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 Graph 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"
}
],
"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"
}