取得 machineAction API

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

API 描述

透過 ID 擷取特定的 機器行動 。

限制

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

權限

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

  • 使用者至少需要以下角色權限：「檢視資料」。 更多資訊請參見： 建立與管理角色。

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

權限類型 權限 權限顯示名稱
應用程式 機器。讀取寫入。全部 「讀取並寫入所有機器資訊」
委託 (工作或學校帳戶) Machine.ReadWrite 「讀寫機器資訊」

HTTP 要求

GET https://api.security.microsoft.com/api/machineactions/{id}

要求標頭

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

要求內文

Empty

回應

若成功，此方法會回傳 200 個 Ok 回應程式碼並使用 機器行動 實體。 如果找不到指定 ID 的機器動作實體 - 404 未找到。

範例

範例請求

以下是請求的範例。

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

回應範例

以下是回應的範例。

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#MachineActions/$entity",
    "id": "5382f7ea-7557-4ab7-9782-d50480024a4e",
    "type": "Isolate",
    "scope": "Selective",
    "requestor": "Analyst@TestPrd.onmicrosoft.com",
    "requestorComment": "test for docs",
    "status": "Succeeded",
    "machineId": "7b1f4967d9728e5aa3c06a9e617a22a4a5a17378",
    "computerDnsName": "desktop-test",
    "creationDateTimeUtc": "2019-01-02T14:39:38.2262283Z",
    "lastUpdateDateTimeUtc": "2019-01-02T14:40:44.6596267Z",
    "relatedFileInfo": null
}
  • Last updated on