解除裝置隔離 API

  • 適用於: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2, Microsoft Defender for Business

API 描述

解除裝置的隔離。

在隔離裝置時，只有特定的程序和目的地被允許。 裝置被完整 VPN 隧道保護的裝置，在裝置被隔離後，將無法連接到 適用於端點的 Microsoft Defender 雲端服務。 我們建議使用 split-tunneling VPN，針對 適用於端點的 Microsoft Defender 和 Microsoft Defender 防毒軟體這些雲端防護相關流量。

限制

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

必要條件

支援的作業系統

  • Windows 10 版本 1703 裝置可提供完全隔離。
  • 完整隔離功能已在公開預覽版中提供，適用於系統需求中列出的所有支援Linux 適用於端點的 Microsoft Defender。
  • 選擇性隔離功能適用於 Windows 10 版本 1709 或更新版本的裝置。

權限

使用使用者憑證取得令牌時：

  • 使用者至少需要擁有以下角色權限：「主動修復行動」。 更多資訊請參見： 建立與管理角色。
  • 使用者必須根據裝置群組設定取得該裝置的存取權限。 欲了解更多資訊，請參閱： 建立與管理裝置群組。

呼叫此 API 需要以下其中一項權限。 欲了解更多，包括如何選擇權限，請參閱「使用適用於端點的 Microsoft Defender APIS」

權限類型 權限 權限顯示名稱
應用程式 機器。隔離 「隔離機器」
委託 (工作或學校帳戶) 機器。隔離 「隔離機器」

HTTP 要求

POST https://api.security.microsoft.com/api/machines/{id}/unisolate

要求標頭

名稱 類型 描述
授權 字串 持有人 {token}。 必要。
Content-Type 字串 application/json。 必要。

要求內文

在請求主體中，提供一個包含以下參數的 JSON 物件：

參數 Type 描述
留言 字串 留言以與行動相關聯。 必要。

回應

若成功，此方法會在回應體中回傳 201 - 已建立的回應程式碼與 機器動作 。

如果你發送多個 API 呼叫來移除同一裝置的隔離，它會回傳「待處理的機器動作」或 HTTP 400，並顯示「動作已進行中」。

範例

請求

以下是該請求的範例。

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/unisolate

{
  "Comment": "Unisolate machine since it was clean and validated"
}
  • Last updated on