Microsoft Intune Data Warehouse API

Intune Data Warehouse API 允许你以计算机可读格式访问Intune数据,以便在你最喜欢的分析工具中使用。 可以使用 API 生成报表,以便深入了解企业移动环境。 API 使用 OData 协议,该协议遵循以下标准模式:

  • 请求和响应标头
  • 状态代码
  • HTTP 方法
  • URL 约定
  • 媒体类型
  • 有效负载格式
  • 查询选项

OData (开放数据协议) 是一个组织,用于推进结构化信息标准 (OASIS) 标准,该标准定义了生成和使用 RESTful API 的最佳做法。 Intune Data Warehouse使用 OData 版本 4.0。

本参考部分概述了终结点、支持的 HTTP 方法、返回有效负载格式以及Intune Data Warehouse数据模型的文档。

重要

可以使用 beta 版本试用 Data Warehouse 的最新功能。 若要使用 beta 版本,URL 必须包含查询参数 api-version=beta。 beta 版本在作为受支持的服务正式发布之前提供这些功能。 随着Intune添加新功能,beta 版本可能会更改行为和数据协定。 依赖于 beta 版本的任何自定义代码或报告工具都可能会中断正在进行的更新。

OData 自定义客户端

可以通过 RESTful 终结点访问Intune Data Warehouse数据模型。 若要访问数据,客户端必须使用 OAuth 2.0 Microsoft Entra ID授权。 首先在 Azure 中设置 Web 应用和客户端应用,向客户端授予权限。 本地客户端获取授权,然后可以与Data Warehouse终结点通信。

有关详细信息,请参阅使用 REST 客户端从 Data Warehouse API 获取数据

注意

可以在 Github 上访问 GitHub Intune Data Warehouse存储库以获取代码示例。

与 API 交互

API 需要使用Microsoft Entra ID授权。 Microsoft Entra ID使用 OAuth 2.0。 授权后,可以使用 HTTP GET 谓词并联系公开的实体集合从 API 获取数据。 有关详细信息,请参阅:

Intune Data Warehouse数据模型

OData 定义了一个抽象数据模型和一个协议,允许任何客户端访问任何数据源公开的信息。 数据模型文档主题包含Intune Data Warehouse数据模型中的命名空间、实体和返回对象的说明。 有关详细信息,请参阅Data Warehouse数据模型

后续步骤

阅读Microsoft Entra ID的身份验证方案,详细了解如何使用 Microsoft Entra ID。

odata.org 查找 OData 资源。

在 OData 版本 4.0 中查看 OData 版本 4.0 标准。