accessReviewInstance 资源类型

命名空间:microsoft.graph

表示 Azure AD 访问评审 定期。 基于父 accessReviewScheduleDefinition 对象生成的系统。 所有属性都是只读的。

如果实例是定期访问评审的一部分,则实例表示每一次重复。 不重复的审阅将完全有一个实例。 实例还表示计划定义中正在审查的每个唯一资源。 如果计划定义对多个资源进行评审,则每个资源将为每个重复周期提供唯一实例。

每个 accessReviewInstance 都包含审阅者可以执行的 决策 列表。 每个标识都有一个要审查的决定。

继承自 entity

Methods

方法 返回类型 说明
列出 accessReviewInstances accessReviewInstance 集合 获取 accessReviewInstance 对象及其属性的列表。
获取 accessReviewInstance accessReviewInstance 读取 accessReviewInstance 对象的属性和关系。
更新 accessReviewInstance accessReviewInstance 更新 accessReviewInstance 对象的审阅者。
filterByCurrentUser accessReviewInstance 集合 返回调用用户为审阅者的定义上的所有实例对象。
列出联系的审阅者 accessReviewReviewer 集合 获取收到访问评审实例通知的审阅者。
sendReminder 向 accessReviewInstance 的审阅者发送提醒。
stop 手动停止 accessReviewInstance。
acceptRecommendations 允许调用用户接受针对每个 NotReviewed accessReviewInstanceDecisionItem 的决策建议,即他们是特定 accessReviewInstance 的审阅者。
applyDecisions 对 accessReviewInstance 手动应用决策。
batchRecordDecisions 在一次调用中查看主体或资源的批处理。
resetDecisions 将实例上的所有决策项重置为 notReviewed
列出决策 accessReviewInstanceDecisionItem 集合 从决策导航属性获取 accessReviewInstanceDecisionItem 资源。

属性

属性 类型 说明
endDateTime DateTimeOffset 当审阅实例计划结束时,DateTime。DatetimeOffset 类型表示使用 ISO 8601 格式的日期和时间信息,并且始终采用 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $select。 只读。
fallbackReviewers accessReviewReviewerScope 集合 此审阅者范围集合用于定义回退审阅者列表。 如果未从指定的审阅者列表中找到任何用户,则会通知这些回退审阅者采取行动。 如果组所有者被指定为审阅者,但组所有者不存在,或者经理被指定为审阅者,但用户的管理器不存在,则可能会发生这种情况。 支持 $select
id String 实例的唯一标识符。 继承自 entity。 支持 $select。 只读。
scope accessReviewScope 基于 accessReviewScheduleDefinition 级别的范围和 instanceEnumerationScope 创建。 定义在组中审阅的用户的范围。 仅支持 $select$filter (contains) 。 只读。
startDateTime DateTimeOffset 计划启动审阅实例时的 DateTime。 将来可能。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $select。 只读。
status 字符串 指定 accessReview 的状态。 可能的值:InitializingNotStartedStartingInProgressCompletingCompletedAutoReviewing``AutoReviewed。 仅支持$select$orderby``$filter (eq) 。 只读。
评论家 accessReviewReviewerScope 集合 此访问评审范围集合用于定义审阅者是谁。 支持 $select。 有关分配审阅者的选项示例,请参阅使用 Microsoft 图形 API 将审阅者分配到访问评审定义

关系

关系 类型 说明
决定 accessReviewInstanceDecisionItem 集合 AccessReviewInstance 中审阅的每个主体都有一个决策项,表示它们是否已获得批准、拒绝或尚未审查。
contactedReviewers accessReviewReviewer 集合 返回被联系以完成此评审的审阅者的集合。 虽然 accessReviewScheduleDefinition审阅者fallbackReviewers 属性可能会将组所有者或经理指定为 审阅者,但 联系的Reviewers 将返回其个人标识。 支持 $select。 只读。

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"
    }
  ]
}