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

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

Описание API

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

Ограничения

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

Разрешения

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

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

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

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

HTTP-запрос

GET /api/users/{id}/alerts

Идентификатор — это не полное имя участника-пользователя, а только имя пользователя. (например, для получения оповещений для user1@contoso.com использования /api/users/user1/alerts)

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

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

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

переменная Empty

Отклик

В случае успешного выполнения и существования пользователя — 200 ОК. Если пользователь не существует - 200 OK с пустым набором.

Пример

Запрос

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

GET https://api.security.microsoft.com/api/users/user1/alerts
  • Last updated on