Microsoft Graph 报告 API 概述Microsoft Graph reports API overview

Microsoft Graph 中的报告 API 可帮助你了解 Azure Active Directory 租户中的应用程序和资源活动。The reports API in Microsoft Graph enable you to understand application and resource activity in your Azure Active Directory tenant.

为什么使用报告 API?Why use the reports API?

将 Microsoft 365 使用情况报告集成到组织的现有报告解决方案中Integrate Microsoft 365 usage reporting into your organization's existing reporting solution

很多公司都有使用报告应用程序或 Web 门户的现有报告解决方案。Many companies have existing reporting solutions that use a reporting application or web portal. 你可以使用报告 API 将 Microsoft 365 使用情况数据并入组织的现有报告解决方案中,以便所有 IT 服务报告均位于统一位置。You can use the reports API to incorporate Microsoft 365 usage data into your organization's existing reporting solution so that all IT service reports are in a unified location.

保留使用情况报告以供历史分析Retain usage reports for historical analysis

你可以使用报告 API 获取所有使用情况报告中可用的数据,包括每个服务的组织级别的摘要、过去 7/30/90/180 天的实体级别(用户、网站和帐户)的使用情况信息和每日活动聚合。这样可允许你按照要求的时间保存历史使用信息。You can use the reports API to get the data that's available in all usage reports, including organization-level summaries per service, entity-level (user, sites, accounts) usage information for the last 7/30/90/180 days, and daily activity aggregates. This gives you the option to keep historical usage information for as long as required.

分析 AD FS 应用程序活动和配置Analyze AD FS application activity and configuration

提供与使用 Active Directory 联合身份验证服务(以下简称“AD FS”)配置的信赖方相关的信息、其聚合的使用情况,以及是否可以将信赖方配置迁移到 Azure Active Directory。Provides information about a relying party configured with Active Directory Federation Services (AD FS), its aggregated usage, and whether the relying party configuration can be migrated to Azure Active Directory.

监控应用程序登录Monitor application sign-ins

监控应用程序的使用情况以及与使用情况模式相关的决策。Monitor the usage of your applications and make decisions about usage patterns.

确定使用您应用程序的人员及其使用方式Determine who is using your applications and how are they using them

身份验证方法使用情况报告可帮助你了解组织中的用户如何使用 Azure Active Directory (Azure AD) 功能,如自助密码重置和多重身份验证 (MFA)。The authentication methods usage reports help you understand how users in your organization use Azure Active Directory (Azure AD) capabilities, such as self-service password rest and multi-factor authentication (MFA). 这些报告可帮助你确定对组织而言最有效的身份验证方法、最终用户遇到的错误类型,以及帮助最终用户接受使用自动密码重置和 MFA 所需要的市场活动。These reports help you determine which authentication methods are more successful for your organization, what types of errors end users are running into, and hat campaign you need to run to help your end users adopt the use of self-service password rest and MFA.

监控 Azure AD 租户上的活动Monitor activity on an Azure AD tenant

更好地了解用户如何访问和使用 Azure AD 服务。Gain a better understanding of how your users access and use Azure AD services. 可以通过分析数据,创建满足组织特定需求的自定义解决方案。You can analyze the data to create custom solutions tailored to your organization's specific needs.

使用报告 API 可以访问哪些数据?What data can I access by using the reports APIs?

你可以使用报告 API 访问下表中列出的数据集。You can use the reports APIs to access the data sets listed in the following table.

报表 APIReports APIs 数据集Data set
活动Activity 目录审核Directory audit
登录Sign-in
预配(预览版)Provisioning (Preview)
AD FS 应用程序AD FS applications 信赖方详细摘要(预览版)Relying part detailed summary (Preview)
应用程序注册Application registration 凭据用户注册计数(预览版)Credential user registration count (Preview)
凭据用户注册详细信息(预览版)Credential user registration details (Preview)
用户凭据使用情况详细信息(预览版)User credential usage details (Preview)
凭据使用情况摘要(预览版)Credential usage summary (Preview)
应用程序登录Application sign-in 登录摘要(预览版)Sign-in summary (Preview)
登录详细信息(预览版)Sign-in details (Preview)
Microsoft TeamsMicrosoft Teams 设备使用情况Device usage
用户活动User activity
Microsoft 365(常规)Microsoft 365 (general) 激活Activations
活动用户Active users
组活动Groups activity
OneDriveOneDrive 活动Activity
使用情况Usage
OutlookOutlook 活动Activity
应用使用情况App usage
邮箱使用情况Mailbox usage
SharePointSharePoint 活动Activity
网站使用情况Site usage
Skype for BusinessSkype for Business 活动Activity
设备使用情况Device usage
设备使用情况Device usage
参与者活动Participant activity
对等活动Peer to peer activity
YammerYammer 活动Activity
设备使用情况Device usage
组活动Groups activity

API 参考API reference

在查找此服务的 API 参考?Looking for the API reference for this service?

后续步骤Next steps