共用方式為

Intune 資料倉儲 API 端點

  • 發行項

您可以使用 Intune Data Warehouse API 搭配具有特定角色型存取控制和 Microsoft Entra 認證的帳戶。 接著，您會使用 OAuth 2.0，透過 Microsoft Entra ID 授權您的 REST 用戶端。 最後，您將形成有意義的 URL 來呼叫數據倉儲資源。

Microsoft Entra ID 和 Intune 認證需求

驗證和授權是以 Microsoft Entra 認證為基礎，Intune 角色型訪問控制 (RBAC) 。 根據預設，租使用者的所有全域管理員和 Intune 服務管理員都可存取數據倉儲。 使用 Intune 角色，讓他們存取 Intune 數據倉儲資源，以提供更多使用者的存取權。

存取 Intune 資料倉儲 (包括 API) 的需求為：

  • 用戶必須至少有下列其中一個角色：
    • Intune 服務系統管理員
    • 具有 Intune 數據倉儲資源角色型存取權的使用者
    • 使用僅限應用程式驗證的無用戶驗證

重要事項

若要指派 Intune 角色並存取 Intune Data Warehouse，用戶必須擁有 Intune 授權。 如需詳細資訊，請參閱使用 Microsoft Intune 和 Microsoft Intune 授權 (RBAC) 角色型訪問控制。

授權

Microsoft Entra ID 使用 OAuth 2.0，讓您能夠授權存取 Microsoft Entra 租使用者中的 Web 應用程式和 Web API。 本指南與語言無關，並說明如何在不使用任何開放原始碼連結庫的情況下傳送和接收 HTTP 訊息。 OAuth 2.0 授權碼流程說明於 OAuth 2.0 規格的第 4.1 節 。

如需詳細資訊，請參閱使用 OAuth 2.0 和 Microsoft Entra ID 授權存取 Web 應用程式。

API URL 結構

Data Warehouse API 端點會讀取每個集合的實體。 API 支援 GET HTTP 動詞命令，以及查詢選項的子集。

Intune 的網址使用下列格式：
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 試用版 Version 是要存取的 API 版本。 如需詳細資訊，請參閱 版本。
maxhistorydays 7 (選擇性) 要擷取的記錄天數上限。 這個參數可以提供給任何集合，但只會對包含 dateKey 為其索引鍵屬性一部分的集合生效。 如需詳細資訊，請參閱 DateKey 範圍篩選 。

API 版本資訊

您現在可以藉由設定查詢參數 api-version=v1.0來使用 v1.0 版本的 Intune Data Warehouse。 匯報 Data Warehouse 中的集合本質上是加法的，而且不會中斷現有的案例。

您可以使用 beta 版本來試用 Data Warehouse 的最新功能。 若要使用 Beta 版本，您的網址必須包含查詢參數 api-version=beta。 Beta 版本會在功能正式推出為支援的服務之前提供這些功能。 隨著 Intune 新增功能，Beta 版本可能會變更行為和數據合約。 任何相依於 Beta 版本的自定義程式碼或報告工具，都可能會因為進行中的更新而中斷。

OData 查詢選項

目前的版本支援下列 OData 查詢參數：$filter、 $select$skip, 和 $top。 在 $filter中，只有 DateKey 當數據行適用時才支援 或 RowLastModifiedDateTimeUTC ，而其他屬性會觸發錯誤的要求。

DateKey 範圍篩選

DateKey 範圍篩選可用來限制某些集合 dateKey 要下載的數據量，並以 做為索引鍵屬性。 篩選 DateKey 可用來藉由提供下列 $filter 查詢參數來優化服務效能：

  1. DateKey 單獨在 中 $filter，支持運算 lt/le/eq/ge/gt 符，並與邏輯運算符 and聯結，其中它們可以對應至開始日期和/或結束日期。
  2. maxhistorydays 會以自定義查詢選項提供。

篩選範例

注意事項

篩選範例假設現今是 2/21/2018。

篩選器 效能優化 描述
maxhistorydays=7 Full 傳回介於 DateKey 20180214 和 20180221 之間的數據。
$filter=DateKey eq 20180214 Full DateKey傳回等於 20180214 的數據。
$filter=DateKey ge 20180214 and DateKey lt 20180221 Full 傳回介於 DateKey 20180214 和 20180220 之間的數據。
maxhistorydays=7&$filter=DateKey eq 20180214 Full DateKey傳回等於 20180214 的數據。 maxhistorydays 會忽略 。
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z Full 傳回的數據 RowLastModifiedDateTimeUTC 大於或等於 2018-02-21T23:18:51.3277273Z