Listar a API de inventário de software

  • Aplica-se a: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1

Descrição da API

Obtém o inventário de software da organização.

Suporta consultas OData V4. Operadores suportados pelo OData:

  • $filter nas seguintes propriedades:
    • id
    • name
    • vendor
  • $top com o valor máximo de 10 000.
  • $skip

Veja exemplos em Consultas OData com Microsoft Defender para Ponto de Extremidade.

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, veja Utilizar Microsoft Defender para Ponto de Extremidade APIs para obter detalhes.

Tipo de permissão Permissão Nome a apresentar da permissão
Application Software.Read.All "Ler informações do Software de Gestão de Ameaças e Vulnerabilidades"
Delegado (conta corporativa ou de estudante) Software.Read "Ler informações do Software de Gestão de Ameaças e Vulnerabilidades"

Solicitação HTTP

GET /api/Software

Cabeçalhos de solicitação

Nome Tipo Descrição
Autorização Cadeia de caracteres {token} de portador. Obrigatório.

Corpo da solicitação

Vazio

Resposta

Se for bem-sucedido, este método devolve 200 OK com o inventário de software no corpo.

Exemplo

Exemplo de solicitação

Este é um exemplo da solicitação.

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

Exemplo de resposta

Veja um exemplo de resposta.

{
    "@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
            }
            ...
        ]
}
  • Last updated on