Поиск устройств по тегу API

Применяется к: Microsoft Defender для конечной точки

Примечание

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

Совет

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

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

Описание API

Поиск машин по тегу.

startswith запрос поддерживается.

Ограничения

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

Разрешения

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

Тип разрешения Разрешение Имя отображения разрешений
Для приложений Machine.Read.All 'Read all machine profiles'
Для приложений Machine.ReadWrite.All 'Read and write all machine information'
Делегированные (рабочая или учебная учетная запись) Machine.Read 'Read machine information'
Делегированные (рабочая или учебная учетная запись) Machine.ReadWrite 'Read and write machine information'

Примечание

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

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

HTTP-запрос

GET /api/machines/findbytag?tag={tag}&useStartsWithFilter={true/false}

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

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

Запрос параметров URI

Имя Тип Описание
tag Строка Имя тега. Обязательное поле.
useStartsWithFilter Логический При наборе true поиск будет находить все устройства с именем тега, которое начинается с данного тега в запросе. Значение по умолчанию: false. Необязательное поле.

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

переменная Empty

Отклик

Если успешно — 200 ОК со списком машин в теле отклика.

Пример

Запрос

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

GET https://api.securitycenter.microsoft.com/api/machines/findbytag?tag=testTag&useStartsWithFilter=true