accessReview 资源类型 (已弃用)
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
警告
此版本的访问评审 API 已弃用，将于 2023 年 5 月 19 日停止返回数据。 请使用 访问评审 API。
表示Microsoft Entra 访问评审。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 列出访问评审 | accessReview 集合 | 列出 businessFlowTemplate 的 accessReviews。 |
| 获取访问审查 | accessReview | 获取具有特定 ID 的访问评审。 |
| 创建访问审查 | accessReview | 创建新的 accessReview。 |
| 更新访问审查 | accessReview | 更新 accessReview。 |
| 删除访问审查 | 无。 | 删除 accessReview。 |
| 列出审阅者 | userIdentity 集合 | 获取 accessReview 的审阅者。 |
| 添加审阅者 | 无。 | 将审阅者添加到 accessReview。 |
| 删除审阅者 | 无。 | 从 accessReview 中删除审阅者。 |
| 列出决策 | accessReviewDecision 集合 | 获取 accessReview 的决策。 |
| 列出我决策 | accessReviewDecision 集合 | 作为审阅者，获取我对 accessReview 的决策。 |
| 发送提醒 | 无。 | 向 accessReview 的审阅者发送提醒。 |
| Stop | 无。 | 停止 accessReview。 |
| Reset | 无。 | 在正在进行的 accessReview 中重置决策。 |
| 应用决策 | 无。 | 从已完成的 accessReview 应用决策。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 访问评审的功能分配唯一标识符。 |
| displayName | String | 访问评审名称。 创建时为必需项。 |
| startDateTime | DateTimeOffset | 计划开始评审的日期和时间。 此日期可以是将来的日期。 创建时为必需项。 |
| endDateTime | DateTimeOffset | 安排评审结束时的 DateTime。 这必须至少比开始日期晚一天。 创建时为必需项。 |
| status | String | 此只读字段指定 accessReview 的状态。 典型状态包括 Initializing、、NotStarted、StartingInProgress、CompletingCompleted、 AutoReviewing和 AutoReviewed。 |
| 说明 | String | 访问评审创建者提供的说明，以向审阅者显示。 |
| businessFlowTemplateId | String | 业务流模板标识符。 创建时为必需项。 此值区分大小写。 |
| reviewerType | String | 审阅者与目标对象的关系类型，其中之一： self、 delegated、 entityOwners。 创建时为必需项。 |
| createdBy | userIdentity | 创建此评审的用户。 |
| reviewedEntity | identity | 访问评审要对其评审访问权限分配的对象。 此标识可以是用于评审组中用户成员身份的组，也可以是用于评审用户分配到应用程序的应用。 创建时为必需项。 |
| settings | accessReviewSettings | accessReview 的设置，请参阅下面的类型定义。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 评论家 | userIdentity 集合 | 访问评审的审阅者集合（如果访问评审审阅者类型为 delegated）。 |
| 决定 | accessReviewDecision 集合 | 此访问评审的决策集合。 |
| myDecisions | accessReviewDecision 集合 | 调用方决策的集合（如果调用方是审阅者）。 |
| 实例 | accessReview 集合 | 过去、现在和将来的访问评审实例的集合（如果此对象是定期访问评审）。 |
这些关系是否存在于对象上，取决于对象是一次性访问评审、定期访问评审的系列还是定期访问评审的实例。
| 应用场景 | 审阅者吗？ | 有决策和 myDecisions 吗？ | 有实例？ |
|---|---|---|---|
| 一次性访问评审 | 是 | 是，一旦启动 | 否 |
| 定期访问评审 | 是 | 否 | 是 |
| 定期访问评审的实例 | 是 | 是，一旦启动 | 否 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"id": "string (identifier)",
"displayName": "string",
"startDateTime": "string (timestamp)",
"endDateTime": "string (timestamp)",
"status": "string",
"description": "string",
"businessFlowTemplateId": "string (identifier)",
"reviewerType": "string",
"createdBy": {"@odata.type": "microsoft.graph.userIdentity"},
"reviewedEntity": {"@odata.type": "microsoft.graph.identity"},
"settings": {"@odata.type": "microsoft.graph.accessReviewSettings"},
"reviewers": [{"@odata.type": "microsoft.graph.userIdentity"}]
}