活动报告 API 概述
命名空间：microsoft.graph
Microsoft Entra ID跟踪用户活动并创建报表，帮助你了解用户如何访问和使用Microsoft Entra服务。 使用 Microsoft 图形 API for Microsoft Entra ID 分析这些报表中的数据，并创建适合组织特定需求的自定义解决方案。
这些活动报告的可用性由Microsoft Entra数据保留策略控制。 有关详细信息，请参阅 数据保留策略。
什么是Microsoft Entra活动日志？
Microsoft Entra ID提供以下类型的活动报告：
- 目录审核
- 登录
目录审核
借助目录审核报告，你可以获取租户中执行的每项任务的历史记录。 目录审核报告为你提供了系统合规活动的记录。 除此之外，提供的数据还可让你了解常见情景，例如：
- 谁向管理员组授予了访问目录用户的权限？
- 哪些用户正在登录最近购买的应用程序？
- 在目录中进行了多少次密码重置？
登录
登录活动报告可帮助你确定负责执行目录审核所报告的任务的人员。 登录报告可帮助你回答如下问题：
- 用户的登录模式是什么？
- 上周有多少用户进行了登录？
- 这些登录的状态如何？
可以使用 Microsoft Graph 中的审核日志 API 做什么？
以下是处理审核日志数据的常见请求：
| Operation | URL |
|---|---|
| 获取租户用户活动 | GET https://graph.microsoft.com/v1.0/auditLogs/directoryAudits |
| 获取租户用户登录信息 | GET https://graph.microsoft.com/v1.0/auditLogs/signIns |
许可要求
活动报告适用于已获得许可的功能。 如果你拥有特定功能的许可证，则还可以访问报告。 有关不同活动报表的许可证要求的详细信息，请参阅Microsoft Entra审核日志：许可证和角色要求。
相关内容
- 开始使用表示不同活动报告的以下资源：
- directoryAudit 资源类型。
- signIn 资源类型。
- provisioningObjectSummary 资源类型。