Microsoft Intune Data Warehouse API
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 的最新功能。 若要使用 Beta 版本,您的網址必須包含查詢參數 api-version=beta
。 Beta 版本會在功能正式推出為支援的服務之前提供這些功能。 隨著 Intune 新增功能,Beta 版本可能會變更行為和數據合約。 任何相依於 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 版標準。