Intune Data Warehouse 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 數據倉儲 資源角色型存取權的使用者
  • 使用僅限應用程式驗證的無使用者驗證

授權

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 的 URL 會使用下列格式： https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

URL 包含下列元素：

API 版本資訊

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

您可以使用 Beta 版本試用 Data Warehouse 的最新功能。 若要使用測試版，您的URL必須包含查詢引數 api-version=beta。 測試版在作為支援服務正式推出之前提供功能。 隨著 Intune 新增功能，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 作為自訂查詢選項提供。
   

篩選範例