大网数据广告活动
Microsoft Graph 接口

活动报告 API 概述

· 52CE 我爱测

使用 Microsoft Graph 中的活动报告 API 访问 Azure Active Directory 创建的报告,跟踪租户中的用户活动。

命名空间:microsoft.graph

Azure Active Directory (Azure AD) 可跟踪用户活动和创建报告,以帮助你了解用户如何访问和使用 Azure AD 服务。 使用 Microsoft Graph API for Azure AD 分析这些报告中的数据,并根据组织的特定需求创建自定义解决方案。

这些活动报告的可用性受 Azure AD 的数据保留策略管理。 有关详细信息,请参阅 数据保留策略。

什么是 Azure AD 活动日志?

Azure AD 提供以下三种类型的活动报告:

  • 目录审核
  • 登录

目录审核

借助目录审核报告,你可以获取租户中执行的每项任务的历史记录。 目录审核报告为你提供了系统合规活动的记录。 除此之外,提供的数据还可让你了解常见情景,例如:

  • 谁向管理员组授予了访问目录用户的权限?
  • 哪些用户正在登录最近购买的应用程序?
  • 在目录中进行了多少次密码重置?

登录

登录活动报告可帮助你确定负责执行目录审核所报告的任务的人员。 登录报告可帮助你回答如下问题:

  • 用户的登录模式是什么?
  • 上周有多少用户进行了登录?
  • 这些登录的状态如何?

可以使用 Microsoft Graph 中的审核日志 API 做什么?

以下是处理审核日志数据的常见请求:

Operation URL
获取租户用户活动 GET https://graph.microsoft.com/v1.0/auditLogs/directoryAudits
获取租户用户登录信息 GET https://graph.microsoft.com/v1.0/auditLogs/signIns

需要哪些许可证?

活动报告适用于已获得许可的功能。 如果你拥有特定功能的许可证,则还可以访问报告。

例如,你需要 Azure AD Premium P1 许可证才能访问自助密码审核报告。 若要了解详细信息,请参阅 Azure AD 许可。

登录报告需要 Azure AD Premium 许可证。

若要了解详细信息,请参阅 Azure AD 定价。

后续步骤

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 besiler)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。