Microsoft Intune 数据仓库 API

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

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

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

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

重要

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

OData 自定义客户端

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

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

注意

可以访问 Github 上的 GitHub Intune 数据仓库存储库 以获取代码示例。

与 API 交互

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

Intune 数据仓库数据模型

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

后续步骤

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

odata.org 查找 OData 资源。

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