Поделиться через

СПИСОК API инвентаризации программного обеспечения

  • Статья

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

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

Примечание.

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

Совет

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

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com
  • ina.api.security.microsoft.com

Описание API

Извлекает данные инвентаризации программного обеспечения организации.
Поддерживает запросы OData версии 4.
Поддерживаемые операторы OData:
$filter on: id, nameи vendor свойства.
$top с максимальным значением 10 000.
$skip.
Примеры см. в статье Запросы OData с помощью Microsoft Defender для конечной точки.

Разрешения

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

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

HTTP-запрос

GET /api/Software

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

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

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

переменная Empty

Отклик

В случае успешного выполнения этот метод возвращает значение 200 ОК с инвентаризацией программного обеспечения в тексте.

Пример

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

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

GET https://api.security.microsoft.com/api/Software

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

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

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
    "value": [
            {
                "id": "microsoft-_-edge",
                "name": "edge",
                "vendor": "microsoft",
                "weaknesses": 467,
                "publicExploit": true,
                "activeAlert": false,
                "exposedMachines": 172,
                "impactScore": 2.39947438
            }
            ...
        ]
}

Совет

Хотите узнать больше? Обратитесь к сообществу Майкрософт по безопасности в техническом сообществе Microsoft Defender для конечной точки Tech Community.