通过

获取 machineAction API

  • 适用于: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

API 说明

按 ID 检索特定 计算机作 。

限制

  • 此 API 的速率限制是每分钟 100 个调用和每小时 1500 个调用。

权限

使用用户凭据获取令牌时：

  • 用户至少需要具有以下角色权限：“查看数据”。 有关详细信息，请参阅： 创建和管理角色。

要调用此 API，需要以下权限之一。 若要了解详细信息（包括如何选择权限），请参阅 使用 Defender for Endpoint API。

权限类型 权限 权限显示名称
应用程序 Machine.ReadWrite.All “读取和写入所有计算机信息”
委派（工作或学校帐户） Machine.ReadWrite “读取和写入计算机信息”

HTTP 请求

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

请求标头

名称 类型 说明
Authorization String 持有者 {token}。 必需。

请求正文

Empty

响应

如果成功，此方法使用 计算机作 实体返回 200，正常响应代码。 如果未找到具有指定 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