取得使用者相關電腦 API

適用於：

• 適用於端點的 Microsoft Defender 方案 1
• 適用於端點的 Microsoft Defender
• Microsoft Defender XDR

想要體驗適用於端點的 Microsoft Defender 嗎? 注册免費試用版。

注意事項

如果您是美國政府客戶，請使用美國政府客戶 適用於端點的 Microsoft Defender 中所列的 URI。

提示

為了獲得更好的效能，您可以使用更接近您地理位置的伺服器：

• us.api.security.microsoft.com
• eu.api.security.microsoft.com
• uk.api.security.microsoft.com
• au.api.security.microsoft.com
• swa.api.security.microsoft.com

API 描述

擷取與指定使用者標識碼相關的裝置集合。

限制

此 API 的速率限制為每分鐘 100 次呼叫，每小時 1500 次呼叫。

權限

呼叫此 API 需要下列其中一個許可權。 若要深入瞭解，包括如何選擇許可權，請參閱使用 適用於端點的 Microsoft Defender API

許可權類型	權限	許可權顯示名稱
應用程式	Machine.Read.All	「讀取所有計算機設定檔」
應用程式	Machine.ReadWrite.All	「讀取和寫入所有機器資訊」
委派 (公司或學校帳戶)	Machine.Read	「讀取機器資訊」
委派 (公司或學校帳戶)	Machine.ReadWrite	「讀取和寫入機器資訊」

注意事項

使用使用者認證取得權杖時：

• 使用者至少必須具有下列角色許可權：[檢視數據]。 如需詳細資訊，請參閱 Create 和管理角色
• 回應只會包含使用者可以根據裝置群組設定存取的裝置。 如需詳細資訊，請參閱 Create 和管理裝置群組。

適用於端點的Defender方案1和方案2支援裝置群組建立。

HTTP 要求

GET /api/users/{id}/machines

標識碼不是完整的UPN，而只是用戶名稱。 例如， (擷取要 user1@contoso.com 使用 /api/users/user1/machines)

要求標頭

名稱	類型	描述
授權	字串	持有人 {token}。 必要。

要求內文

Empty

回應

如果成功且使用者存在 - 200 確定本文中的 機器 實體清單。 如果使用者不存在 - 200 確定且具有空白集合。

範例

請求

以下是要求的範例。

GET https://api.securitycenter.microsoft.com/api/users/user1/machines

提示

想要深入了解? Engage 技術社群中的 Microsoft 安全性社群：適用於端點的 Microsoft Defender 技術社群。