Listar a API de inventário de software
Aplica-se a:
- Plano 1 do Microsoft Defender para Ponto de Extremidade
- Microsoft Defender para Ponto de Extremidade
Deseja experimentar o Microsoft Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita.
Observação
Se for um cliente do Governo norte-americano, utilize os URIs listados no Microsoft Defender para Ponto de Extremidade para clientes do Us Government.
Dica
Para um melhor desempenho, pode utilizar o servidor mais próximo da localização geográfica:
- 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
Descrição da API
Obtém o inventário de software da organização.
Suporta consultas OData V4.
Operadores suportados pelo OData:
$filter
em: id
, name
e vendor
propriedades.
$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 a seguir um exemplo da 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
}
...
]
}
Tópicos relacionados
- Gerenciamento de Vulnerabilidades do Microsoft Defender
- Gerenciamento de Vulnerabilidades do Defender inventário de software
Dica
Você deseja aprender mais? Engage com a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Ponto de Extremidade Tech Community.