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

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

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

Примечание

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

Совет

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

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

Описание API

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

Ограничения

  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/files/{id}/machines

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

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

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

переменная Empty

Отклик

При успешном и файле существует — 200 ОК со списком машинных сущностями в теле. Если файл не существует - 404 Не найден.

Пример

Запрос

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

GET https://api.securitycenter.microsoft.com/api/files/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/machines