Список API инвентаризации программного обеспеченияList software inventory API

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

Примечание

Если вы клиент правительства США, используйте URL-адреса, указанные в Microsoft Defender для конечных точек для государственных клиентов США.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Совет

Для улучшения производительности можно использовать сервер ближе к географическому расположению:For better performance, you can use server closer to your geo location:

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

Извлекает инвентаризацию программного обеспечения организации.Retrieves the organization software inventory.

РазрешенияPermissions

Для вызова этого API требуется одно из следующих разрешений.One of the following permissions is required to call this API. Дополнительные сведения, в том числе о выборе разрешений, см. в материале Use Microsoft Defender for Endpoint API.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Тип разрешенияPermission type РазрешениеPermission Имя отображения разрешенийPermission display name
ПриложениеApplication Software.Read.AllSoftware.Read.All 'Read Threat and Vulnerability Management Software information''Read Threat and Vulnerability Management Software information'
Делегированные (рабочая или учебная учетная запись)Delegated (work or school account) Software.ReadSoftware.Read 'Read Threat and Vulnerability Management Software information''Read Threat and Vulnerability Management Software information'

HTTP-запросHTTP request

GET /api/Software

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

ИмяName ТипType ОписаниеDescription
AuthorizationAuthorization StringString Bearer {token}.Bearer {token}. Обязательное поле.Required.

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

переменная EmptyEmpty

ОткликResponse

В случае успешного с помощью инвентаризации программного обеспечения в теле этот метод возвращает 200 ОК.If successful, this method returns 200 OK with the software inventory in the body.

ПримерExample

ЗапросRequest

Ниже приведен пример запроса.Here is an example of the request.

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

ОткликResponse

Ниже приведен пример отклика.Here is an example of the response.

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