accessReviewHistoryDefinition 资源类型

命名空间：microsoft.graph

重要

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

表示访问评审历史数据的集合，以及用于收集数据的范围。

accessReviewHistoryDefinition 包含 accessReviewHistoryInstance 对象的列表。 历史记录定义的每个重复周期都会创建一个实例。 对于一次性历史记录定义，只会创建一个实例。

方法

方法	返回类型	Description
List	accessReviewHistoryDefinition 集合	获取 accessReviewHistoryDefinition 对象及其属性的列表。
创建	accessReviewHistoryDefinition	Create新的 accessReviewHistoryDefinition 对象。
Get	accessReviewHistoryDefinition	读取 accessReviewHistoryDefinition 对象的属性和关系。

属性

属性	类型	说明
createdBy	userIdentity	创建此评审历史记录定义的用户。
createdDateTime	DateTimeOffset	创建访问评审定义时的时间戳。
决定	字符串集合	确定哪些评审决策将包含在提取的评审历史记录数据（如果指定）。 创建时可选。 如果未在创建时提供任何决策，则默认包含所有决策。 可能的值为：approve、、deny、dontKnownotReviewed、 和 notNotified。
displayName	String	访问评审历史记录数据收集的名称。 必需。
id	String	为访问评审历史记录定义分配的唯一标识符。
reviewHistoryPeriodEndDateTime	DateTimeOffset	时间戳。 在此日期或之前结束的审阅将包含在提取的历史记录数据中。 仅当未定义 scheduleSettings 时才需要。
reviewHistoryPeriodStartDateTime	DateTimeOffset	时间戳。 从此日期开始或之前开始的审阅将包含在提取的历史记录数据中。 仅当未定义 scheduleSettings 时才需要。
scheduleSettings	accessReviewHistoryScheduleSettings	定期访问评审历史记录定义系列的设置。 仅当未定义 reviewHistoryPeriodStartDateTime 或 reviewHistoryPeriodEndDateTime 时才需要。 尚不支持。
scopes	accessReviewScope 集合	用于限定提取的历史记录数据中包含的评审范围。 提取其范围与此提供的范围匹配的评审。 必填。
status	accessReviewHistoryStatus	表示审阅历史记录数据收集的状态。 可能的值包括 done、inProgress、error、requested、unknownFutureValue。

关系

关系	类型	说明
实例	accessReviewHistoryInstance 集合	如果 accessReviewHistoryDefinition 是重复定义，则实例表示每个重复周期。 不重复的定义将只包含一个实例。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition",
  "id": "String (identifier)",
  "displayName": "String",
  "reviewHistoryPeriodStartDateTime": "String (timestamp)",
  "reviewHistoryPeriodEndDateTime": "String (timestamp)",
  "status": "String",
  "decisions": [
    "String"
  ],
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "scopes": [
    {
      "@odata.type": "microsoft.graph.accessReviewScope"
    }
  ],
  "scheduleSettings": {
    "@odata.type": "microsoft.graph.accessReviewHistoryScheduleSettings"
  }
}