Получение API оповещений, связанных с доменом

  • Применяется к: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

Описание API

Извлекает коллекцию оповещений, связанных с заданным адресом домена.

Ограничения

  • Вы можете запрашивать последние обновления оповещений в соответствии с настроенным периодом хранения.
  • Ограничения скорости для этого API — 100 вызовов в минуту и 1500 вызовов в час.

Разрешения

При получении маркера с помощью учетных данных пользователя пользователь должен иметь по крайней мере следующее разрешение роли: View Data. Дополнительные сведения см. в разделе Создание ролей и управление ими.

Ответ включает только оповещения, связанные с устройствами, к которым у пользователя есть доступ, на основе параметров группы устройств. Дополнительные сведения см. в разделе Создание групп устройств и управление ими.

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

Тип разрешения Разрешение Отображаемое имя разрешения
Приложение Alert.ReadWrite.All "Чтение и запись всех оповещений"
Делегированные (рабочая или учебная учетная запись) Alert.ReadWrite "Чтение и запись оповещений"

HTTP-запрос

GET /api/domains/{domain}/alerts

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

Заголовок Значение
Авторизация String

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

переменная Empty

Отклик

В случае успешного выполнения и существования домена — 200 OK со списком сущностей оповещений . Если домен не существует — 200 OK с пустым набором.

Пример

Запрос

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

GET https://api.security.microsoft.com/api/domains/client.wns.windows.com/alerts
  • Last updated on