匯出裝置防毒健康細節 API 方法與屬性

匯出裝置防毒健康細節 API 描述

取得 Microsoft Defender 防毒裝置健康資訊清單。 這個 API 有不同的 API 呼叫 (方法) 取得不同類型的資料。 由於資料量可能很大，有兩種方式可以擷取：

• JSON API 會以 JSON 回應形式拉取組織內所有資料。 此方法最適合 裝置少於 100-K 的小型組織。 回應是分頁的，所以你可以用回應中的 @odata.nextLink 欄位來取得下一個結果。

• 檔案 此 API 解決方案能更快且更可靠地拉取大量資料，建議給擁有超過 100,000 台裝置的大型組織。 這個 API 會以下載檔案形式拉取你組織內的所有資料。 回應包含從 Azure 儲存下載所有資料的網址。 此 API 允許您從 Azure 儲存裝置下載所有資料，具體如下：

  1. 呼叫 API 以獲得包含所有組織資料的下載網址清單。

  2. 用下載網址下載所有檔案，並依照你的需求處理資料。

使用或 JSON response 使用檔案收集的資料，是當前狀態的快照。 這些資料不包含歷史資料。 要收集歷史資料，你必須將資料儲存在自己的資料儲存中。

關於在Microsoft Defender入口中使用裝置健康與防毒合規報告工具的資訊，請參見：裝置健康與防毒報告於適用於端點的 Microsoft Defender。

必要條件

• 若要讓 Windows Server 2012 R2 與 Windows Server 2016 出現在裝置健康報告中，這些裝置必須使用現代統一解決方案套件進行上線。 欲了解更多資訊，請參閱 Windows Server 2012 R2 與 2016 現代統一解決方案的新功能。

1.1 匯出裝置防毒健康細節 API 方法

1.2 限制

• 最大頁數：200,000
• 此 API 的速率限制：每分鐘 30 次呼叫及每小時 1,000 次呼叫

1.3 匯出裝置防毒健康細節 API 屬性 (JSON 回應)

• 下表中定義的屬性依屬性 ID 字母順序排列。 當你使用這個 API 時，產生的輸出不一定會以表格中列出的相同順序回傳。
• 請注意， rbacgroupname 和 Id 並不支援使用過濾操作符。
• 回覆中可能會回覆更多專欄。 這些欄位可能是暫時的，且可能被移除;只使用已記錄的欄位。

1.4 匯出裝置防毒健康細節 API 屬性 (透過檔案)

在每個匯出檔案中，都有一個屬性叫 DeviceGatheredInfo做 ，裡面包含防毒資料。 它的每個屬性都能提供裝置健康狀況與狀態的資訊。

• 這些檔案採用 gzip 壓縮，並採用多行 .json 格式。
• 下載網址僅有效 3 小時;否則你可以用參數。
• 為了讓資料下載速度達到最高，你可以確保你下載的範圍和資料所在的 Azure 區域相同。
• 每筆紀錄約佔用 1KB 的資料。 在選擇正確 pageSize 參數時，你應該考慮這點。
• 回覆中可能會回覆更多專欄。 這些欄位是暫時的，可能會被移除，因此只使用已記錄的欄位。