活动报告 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 资源类型。