您可以使用 Intune Data Warehouse API 搭配具有特定角色型存取控制和Microsoft Entra認證的帳戶。 接著，您將使用 OAuth 2.0 透過 Microsoft Entra ID 授權您的 REST 用戶端。 最後，您將形成一個有意義的 URL 來調用數據倉庫資源。
Microsoft Entra ID 和 Intune 認證需求
驗證和授權是根據Microsoft Entra認證和 RBAC) (Intune角色型存取控制。 租用戶的所有 Intune 系統管理員預設都可存取資料倉儲。 使用 Intune 角色，授與更多使用者 Intune 資料倉儲資源的存取權，以提供 Intune 存取權。
存取 Intune 資料倉儲 (包括 API) 的需求為：
- 使用者必須至少具備下列其中一個角色：
- Intune 服務系統管理員
- 具有 Intune 資料倉儲資源角色型存取權的使用者
- 使用僅限應用程式驗證的無使用者驗證
重要事項
若要獲指派Intune角色並存取Intune Data Warehouse，使用者必須擁有 Intune 授權。 如需詳細資訊，請參閱角色型存取控制 (RBAC) 搭配Microsoft Intune和Microsoft Intune授權。
授權
Microsoft Entra ID 使用 OAuth 2.0 可讓您授權存取 Microsoft Entra 租用戶中的 web 應用程式和 web api。 本指南是語言獨立的，說明如何在不使用任何開放原始碼程式庫的情況下傳送和接收 HTTP 訊息。 OAuth 2.0 規格的 4.1 節 說明了 OAuth 2.0 授權碼流程。
如需詳細資訊，請參閱使用 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 中，請根據 {location}下表提供的詳細資料取代 、 {entity-collection}和 {api-version} 。
URL 包含下列元素：
| 元素 | 範例 | 描述 |
|---|---|---|
| 位置 | MSUA06 | 您可以在 Microsoft Intune 系統管理中心檢視 Data Warehouse API 刀鋒視窗來找到基底 URL。 |
| 實體集合 | devicePropertyHistories | OData 實體集合的名稱。 如需資料模型中集合和實體的詳細資訊，請參閱 資料模型。 |
| api-version | Beta | 版本是要存取的 API 版本。 如需詳細資訊，請參閱 版本。 |
| MaxHistoryDays | 7 | (選擇性) 要擷取的歷程記錄天數上限。 此參數可以提供給任何集合，但僅對包含在其金鑰屬性一部分的 dateKey 集合才會生效。 如需詳細資訊，請參閱 DateKey 範圍篩選。 |
API 版本資訊
您現在可以透過設定查詢參數來使用 v1.0 版本的Intune Data Warehouseapi-version=v1.0。 對 Data Warehouse 中集合的匯報本質上是累加的，不會中斷現有案例。
您可以使用測試版試用 Data Warehouse 的最新功能。 若要使用 Beta 版，您的 URL 必須包含查詢參數 api-version=beta。 測試版會在作為支援服務正式提供之前先提供功能。 隨著 Intune 新增功能，Beta 版本可能會變更行為和資料合約。 任何依賴於測試版的自訂程式碼或報告工具都可能會因正在進行的更新而中斷。
OData 查詢選項
目前版本支援下列 OData 查詢參數：$filter、 和 $skip,$select$top。 僅在 $filter欄位適用時才 DateKey 支援或 RowLastModifiedDateTimeUTC 可能支援 ，且其他屬性會觸發不正確的要求。
DateKey 範圍篩選
DateKey 範圍篩選可用來限制某些集錦 dateKey 要下載的資料量，並做為索引鍵屬性。
DateKey篩選可用來提供下列$filter查詢參數來最佳化服務效能：
-
DateKey單獨在$filter中，支援lt/le/eq/ge/gt運算子並與邏輯運算子and聯結，其中可以將它們對應到開始日期和/或結束日期。 -
maxhistorydays作為自訂查詢選項提供。
篩選範例
注意事項
篩選範例假設今天是 2/21/2018。
| 篩選器 | 效能最佳化 | 描述 |
|---|---|---|
maxhistorydays=7 |
Full | 傳回介於 20180214 到 20180221 之間的資料 DateKey 。 |
$filter=DateKey eq 20180214 |
Full | 傳回等於 20180214 的資料 DateKey 。 |
$filter=DateKey ge 20180214 and DateKey lt 20180221 |
Full | 傳回介於 20180214 到 20180220 之間的資料 DateKey 。 |
maxhistorydays=7&$filter=DateKey eq 20180214 |
Full | 傳回等於 20180214 的資料 DateKey 。
maxhistorydays 將被忽略。 |
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z |
Full | 傳回資料 RowLastModifiedDateTimeUTC 為 大於或等於 2018-02-21T23:18:51.3277273Z |