生命周期工作流报告 API 概述

生命周期工作流提供的报告使组织能够深入了解组织中用户的生命周期工作流的处理方式。

注意

本文介绍如何从设备或服务导出个人数据。 这些步骤可用于支持一般数据保护条例 (GDPR) 下的义务。 授权租户管理员可以在Microsoft Entra ID环境中使用 Microsoft Graph 来更正、更新或删除最终用户的身份信息,包括客户和员工用户配置文件或个人数据,例如用户名、工作职务、地址或电话号码。

生命周期工作流 API 在 OData 子空间 microsoft.graph.identityGovernance 中定义。

生命周期工作流报表的关键元素

报告功能 说明
用户处理结果 为特定用户执行的 生命周期工作流 的结果。 结果是工作流任务的所有 任务处理结果 的聚合,这些 任务 是生命周期工作流的一部分,并为特定用户执行。
任务处理结果 为特定用户执行的 工作流任务 的结果。
工作流运行 为用户集合执行的 生命周期工作流 的结果。 结果是在间隔内处理或按需执行的用户的所有用户处理结果的聚合。
任务报告 工作流运行中特定工作流任务的任务处理结果的聚合。 使用此报告,可以轻松确定工作流运行中工作流任务的运行状况,因此,如果工作流运行失败,可以更快地识别错误源。

审核日志中的生命周期工作流

生命周期工作流中运行的所有事件都由 Microsoft Entra ID 记录。 这些操作包括创建、更新、删除或运行工作流,以及为应用分配权限。

这些可审核日志由 Microsoft Graph 中的 directoryAudit 资源类型 及其关联的 GET 方法表示。

许可证检查

生命周期工作流功能(包括 API)包含在 Microsoft Entra ID P2 许可证中。 要在其中创建生命周期工作流的租户必须具有有效的购买或试用版,Microsoft Entra ID P2 或 EMS E5 订阅。 有关许可证要求的详细信息,请参阅 生命周期工作流许可证要求

角色和应用程序权限授权检查

调用用户读取生命周期工作流中的报表需要以下Microsoft Entra角色

操作 应用程序权限 调用用户的必需目录角色
阅读 LifecycleWorkflows.Read.All 或 LifecycleWorkflows.ReadWrite.All 全局读取者或生命周期工作流管理员
创建、更新或删除 LifecycleWorkflows.ReadWrite.All 生命周期工作流管理员