Intune 数据仓库 API 终结点

项目
11/19/2024

可以将 Intune Data Warehouse API 与具有特定基于角色的访问控制和Microsoft Entra凭据的帐户一起使用。然后，将使用 OAuth 2.0 向 REST 客户端授权 Microsoft Entra ID。最后，将形成一个有意义的 URL 来调用数据仓库资源。

Microsoft Entra ID和Intune凭据要求

身份验证和授权基于Microsoft Entra凭据和Intune基于角色的访问控制 (RBAC) 。默认情况下，租户的所有全局管理员和Intune服务管理员都有权访问数据仓库。使用Intune角色，通过授予更多用户访问Intune数据仓库资源的权限。

访问 Intune Data Warehouse（包括 API）的要求如下：

用户必须至少具有以下角色之一：
- Intune 服务管理员
- 对Intune数据仓库资源具有基于角色访问权限的用户
- 使用仅限应用程序的身份验证进行无用户身份验证

重要

若要分配Intune角色并访问Intune Data Warehouse，用户必须具有Intune许可证。有关详细信息，请参阅基于角色的访问控制 (具有Microsoft Intune和Microsoft Intune许可的 RBAC) 。

Authorization

Microsoft Entra ID使用 OAuth 2.0 授权访问Microsoft Entra租户中的 Web 应用程序和 Web API。本指南独立于语言，介绍如何在不使用任何开放源代码库的情况下发送和接收 HTTP 消息。 OAuth 2.0 规范的第 4.1 节介绍了 OAuth 2.0 授权代码流。

有关详细信息，请参阅使用 OAuth 2.0 授权访问 Web 应用程序和Microsoft Entra ID。

API URL 结构

Data Warehouse API 终结点读取每个集的实体。 API 支持 GET HTTP 谓词和查询选项的子集。

Intune的 URL 使用以下格式：
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

注意

在上面的 URL 中，根据下表中提供的详细信息替换 {location}、 {entity-collection}和 {api-version} 。

URL 包含以下元素：

元素	示例	说明
位置	msua06	可以通过查看Microsoft Intune管理中心的“Data Warehouse API”边栏选项卡来找到基 URL。
entity-collection	devicePropertyHistories	OData 实体集合的名称。有关数据模型中的集合和实体的详细信息，请参阅数据模型。
api-version	beta	版本是要访问的 API 的版本。有关详细信息，请参阅版本。
maxhistorydays	7	(可选) 要检索的历史记录的最大天数。此参数可以提供给任何集合，但仅对作为其键属性的一部分包含 `dateKey` 的集合生效。有关详细信息，请参阅 DateKey 范围筛选器。

API 版本信息

现在，可以通过设置查询参数 api-version=v1.0来使用 v1.0 版本的 Intune Data Warehouse。 Data Warehouse中的集合汇报本质上是累加的，不会中断现有方案。

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

OData 查询选项

当前版本支持以下 OData 查询参数：$filter、 $select$skip, 和 $top。在中 $filter，仅 DateKey 当列适用时，才支持或 RowLastModifiedDateTimeUTC ，而其他属性会触发错误的请求。

DateKey 范围筛选器

DateKey 范围筛选器可用于限制某些集合下载的数据量，并将 dateKey 作为键属性。筛选器 DateKey 可用于通过提供以下 $filter 查询参数来优化服务性能：

DateKey 仅在中 $filter，支持 lt/le/eq/ge/gt 运算符，并与逻辑运算符 and联接，其中它们可以映射到开始日期和/或结束日期。
maxhistorydays 作为自定义查询选项提供。

筛选器示例

注意

筛选器示例假设今天为 2018 年 2 月 21 日。

筛选器	性能优化	说明
`maxhistorydays=7`	完整	返回20180214 `DateKey` 和20180221之间的数据。
`$filter=DateKey eq 20180214`	完整	返回等于 20180214 的数据 `DateKey` 。
`$filter=DateKey ge 20180214 and DateKey lt 20180221`	完整	返回20180214 `DateKey` 和20180220之间的数据。
`maxhistorydays=7&$filter=DateKey eq 20180214`	完整	返回等于 20180214 的数据 `DateKey` 。 `maxhistorydays` 将被忽略。
`$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z`	完整	返回的数据 `RowLastModifiedDateTimeUTC` 大于或等于 `2018-02-21T23:18:51.3277273Z`

通过