Intune 資料倉儲 APIIntune Data Warehouse API

Intune 資料倉儲 API 可讓您存取電腦可讀格式的 Intune 資料,以用於您慣用的分析工具。The Intune Data Warehouse API lets you access your Intune data in a machine-readable format for use in your favorite analytics tool. 您可以使用 API 來建置報表,以深入了解您的企業行動環境。You can use the API to build reports that provide insight into your enterprise mobile environment. API 使用 OData 通訊協定,其遵循下列項目的標準模式:The API uses the OData protocol, which follows standard patterns for:

  • 要求與回應標頭Request and response headers
  • 狀態碼Status codes
  • HTTP 方法HTTP methods
  • URL 慣例URL conventions
  • 媒體類型Media types
  • 裝載格式Payload formats
  • 查詢選項Query options

OData (開放式資料通訊協定) 是一種 Organization for the Advancement of Structured Information Standards (OASIS) 標準,可定義用於建置和使用 RESTful API 的最佳做法。The OData (Open Data Protocol) is an Organization for the Advancement of Structured Information Standards (OASIS) standard that defines the best practice for building and consuming RESTful APIs. Intune 資料倉儲會使用 OData 版本 4.0。The Intune Data Warehouse uses OData version 4.0.

本參考章節概述端點、所支援 HTTP 方法、傳回裝載格式,以及 Intune 資料倉儲資料模型的文件。This reference section provides an overview of endpoints, supported HTTP methods, return payload formats, and documentation of the Intune Data Warehouse data model.

重要

您可以使用搶鮮版 (Beta) 來試用最新資料倉儲功能。You can try out the latest functionality of the Data Warehouse by using the beta version. 若要使用搶鮮版 (Beta),URL 必須包含查詢參數 api-version=betaTo use the beta version, your URL must contain the query parameter api-version=beta. 搶鮮版 (Beta) 會先提供功能,再將它們正式推出為支援的服務。The beta version offers features before they are made generally available as a supported service. Intune 新增功能時,搶鮮版 (Beta) 可能會變更行為和資料合約。As Intune adds new features, the beta version may change behavior and data contracts. 與搶鮮版 (Beta) 相依的任何自訂程式碼或報告工具都可能會中斷進行中更新。Any custom code or reporting tools dependent on the beta version may break with ongoing updates.

OData 自訂用戶端OData custom client

您可以透過 RESTful 端點存取 Intune 資料倉儲資料模型。You can access the Intune Data Warehouse data model through RESTful endpoints. 若要存取您的資料,您的用戶端必須使用 OAuth 2.0 向 Azure Active Directory (Azure AD) 進行授權。To gain access to your data, your client must authorize with Azure Active Directory (Azure AD) using OAuth 2.0. 您可以先在 Azure 中設定 Web 應用程式和用戶端應用程式,並授與用戶端的權限。You first set up a web app and a client app in Azure, grant permissions to the client. 您的本機用戶端將取得授權,接著可以與資料倉儲端點進行通訊。Your local client gets authorization and can then communicate with the Data Warehouse endpoints.

如需詳細資訊,請參閱使用 REST 用戶端從資料倉儲 API 取得資料For more information, see Get data from the Data Warehouse API with a REST client

注意

您可以存取 Github 上的 GitHub Intune 資料倉儲儲存機制以取得程式碼範例。You can access the GitHub Intune Data Warehouse repo on Github for code samples.

與 API 互動Interacting with the API

API 需要使用 Azure AD 進行授權。The API requires authorization with Azure AD. Azure AD 使用 OAuth 2.0。Azure AD uses OAuth 2.0. 授權之後,您可以使用 HTTP GET 動詞並連絡公開的實體集合,以從 API 取得資料。Once authorized, you can get data from the API using an HTTP GET verb and contacting the exposed entity collections. 如需詳細資料,請參閱:For details see:

Intune 資料倉儲資料模型Intune Data Warehouse data model

OData 會定義抽象資料模型和通訊協定,可讓任何資料來源所公開的任何用戶端存取資訊。OData defines an abstract data model and a protocol that let any client access information exposed by any data source. 資料模型文件主題包含 Intune 資料倉儲資料模型中命名空間、實體和傳回物件的說明。The data model documentation topic contains an explanation of the namespaces, entities, and return objects in the Intune Data Warehouse data model. 如需詳細資訊,請參閱資料倉儲資料模型For more information, see Data Warehouse Data Model.

接下來的步驟Next steps

藉由閱讀 Azure AD 的驗證案例,深入了解使用 Azure AD。Learn more about working with Azure AD by reading the Authentication Scenarios for Azure AD.

odata.org 尋找 OData 資源。Find OData resources at odata.org.

檢閱 [OData 第 4.0 版] (http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html) 的 OData 第 4.0 版標準Review the OData Version 4.0 standard at [OData Version 4.0] (http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html)