取消機器動作 API

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

重要事項

本文中的部分資訊與發行前版本產品有關，在產品正式發行前可能會大幅度修改。 Microsoft 對此處提供的資訊，不提供任何明確或隱含的瑕疵擔保。

API 描述

取消已啟動且尚未進入最終狀態的機器動作 (完成、取消、失敗) 。

限制

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

權限

呼叫此 API 需要以下其中一項權限。 欲了解更多，包括如何選擇權限，請參閱 「開始使用」。

權限類型 權限 權限顯示名稱
應用程式 Machine.CollectForensics
機器。隔離
Machine.RestrictExecution
機器掃描
機器。離船
機器。停止並隔離
機器。即時回應		 收集法醫資料
隔離電腦
限制程式碼執行
掃描機
使電腦下線
停止與隔離
在特定機器上執行即時回應
委託 (工作或學校帳戶) Machine.CollectForensics
機器。隔離
Machine.RestrictExecution
機器掃描
機器。離船
機器。停止與隔離機器。即時回應		 收集法醫資料
隔離電腦
限制程式碼執行
掃描機
使電腦下線
停止與隔離
在特定機器上執行即時回應

HTTP 要求

POST https://api.security.microsoft.com/api/machineactions/<machineactionid>/cancel

要求標頭

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

要求內文

參數 Type 描述
留言 字串 留言以連結取消行動。

回應

若成功，此方法會回傳 200 個 OK 的回應程式碼，並帶有機器行動實體。 如果找不到具有指定 ID 的機器行動實體——404 未找到。

範例

請求

以下是請求的範例。

POST
https://api.security.microsoft.com/api/machineactions/aaaabbbb-0000-cccc-1111-dddd2222eeee/cancel

{
    "Comment": "Machine action was canceled by automation"
}
  • Last updated on