Listar API de inventário de softwareList software inventory API

Aplica-se a: Microsoft Defender para Ponto de ExtremidadeApplies to: Microsoft Defender for Endpoint

Observação

Se você for um cliente do Governo dos EUA, use os URIs listados no Microsoft Defender for Endpoint para clientes do Governo dos EUA.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Dica

Para melhorar o desempenho, você pode usar o servidor mais próximo de sua localização geográfica: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

Recupera o inventário de software da organização.Retrieves the organization software inventory.

PermissõesPermissions

Uma das seguintes permissões é necessária para chamar essa API.One of the following permissions is required to call this API. Para saber mais, incluindo como escolher permissões, consulte Use Microsoft Defender for Endpoint APIs para obter detalhes.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Tipo de permissãoPermission type PermissãoPermission Nome de exibição de permissãoPermission display name
AplicativoApplication Software.Read.AllSoftware.Read.All 'Ler informações do Software de Gerenciamento de Ameaças e Vulnerabilidades''Read Threat and Vulnerability Management Software information'
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Software.ReadSoftware.Read 'Ler informações do Software de Gerenciamento de Ameaças e Vulnerabilidades''Read Threat and Vulnerability Management Software information'

Solicitação HTTPHTTP request

GET /api/Software

Cabeçalhos de solicitaçãoRequest headers

NomeName TipoType DescriçãoDescription
AutorizaçãoAuthorization Cadeia de caracteresString Portador {token}.Bearer {token}. Obrigatório.Required.

Corpo da solicitaçãoRequest body

VazioEmpty

RespostaResponse

Se tiver êxito, este método retornará 200 OK com o inventário de software no corpo.If successful, this method returns 200 OK with the software inventory in the body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

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

ResponseResponse

Veja a seguir um exemplo da resposta.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
            }
            ...
        ]
}