Получение API machineAction

  • Статья
  • Чтение занимает 2 мин

Область применения:

Хотите попробовать Microsoft Defender для конечной точки? Зарегистрироваться для бесплатной пробной версии.

Примечание.

Если вы клиент для государственных организаций США, используйте универсальные коды ресурса (URI), перечисленные Microsoft Defender для конечной точки для государственных организаций США.

Совет

Для повышения производительности можно использовать сервер ближе к географическому расположению:

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com

Описание API

Извлекает определенное действие компьютера по его идентификатору.

Ограничения

  • Ограничения скорости для этого API : 100 вызовов в минуту и 1500 вызовов в час.

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая выбор разрешений, см. в статье "Использование API Defender для конечной точки".

Тип разрешения Разрешение Отображаемое имя разрешения
Application Machine.Read.All Чтение всех профилей компьютеров
Application Machine.ReadWrite.All "Чтение и запись всех сведений о компьютере"
Делегированные (рабочая или учебная учетная запись) Machine.Read "Чтение сведений о компьютере"
Делегированные (рабочая или учебная учетная запись) Machine.ReadWrite "Чтение и запись сведений о компьютере"

Примечание.

При получении маркера с использованием учетных данных пользователя:

  • У пользователя должно быть по крайней мере следующее разрешение роли: "Просмотр данных" (дополнительные сведения см. в разделе "Создание ролей и управление ими")

HTTP-запрос

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

Заголовки запросов

Имя Тип Описание
Авторизация String Носитель {token}. Обязательное поле.

Текст запроса

переменная Empty

Отклик

В случае успешного выполнения этот метод возвращает код ответа 200 OK с сущностью Machine Action . Если сущность действия компьютера с указанным идентификатором не найдена — 404 Не найдено.

Пример

Пример запроса

Ниже приведен пример запроса.

GET https://api.securitycenter.microsoft.com/api/machineactions/2e9da30d-27f6-4208-81f2-9cd3d67893ba

Пример ответа

Ниже приведен пример отклика.

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.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
}