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 的最新功能。 若要使用測試版,您的URL必須包含查詢引數 api-version=beta。 測試版在作為支援服務正式推出之前提供功能。 隨著 Intune 新增功能,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 版標準。