Listar software por recomendação

Aplica-se a:

Deseja experimentar o Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita.

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.

Dica

Para melhorar o desempenho, você pode usar o servidor mais próximo de sua localização geográfica:

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

Importante

Algumas informações estão relacionadas a produtos pré-lançados que podem ser substancialmente modificados antes de seu lançamento comercial. A Microsoft não faz garantias, expressas ou implícitas, quanto às informações fornecidas aqui.

Recupera uma recomendação de segurança relacionada a um software específico.

Permissões

Uma das seguintes permissões é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, consulte Use Microsoft Defender for Endpoint APIs para obter detalhes.

Tipo de permissão Permissão Nome de exibição de permissão
Aplicativo Software.Read.All 'Ler informações do Software de Gerenciamento de Ameaças e Vulnerabilidades'
Delegado (conta corporativa ou de estudante) SecurityRecommendation.Read 'Ler informações de recomendação de segurança do Gerenciamento de Ameaças e Vulnerabilidades'

Solicitação HTTP

GET /api/recommendations/{id}/software

Cabeçalhos de solicitação

Nome Tipo Descrição
Autorização String Portador {token}. Obrigatório.

Corpo da solicitação

Vazio

Resposta

Se tiver êxito, este método retornará 200 OK com o software associado às recomendações de segurança no corpo.

Exemplo

Exemplo de solicitação

Este é um exemplo da solicitação.

GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome/software 

Exemplo de resposta

Veja a seguir um exemplo da resposta.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Analytics.Contracts.PublicAPI.PublicProductDto",
    "id": "google-_-chrome",
    "name": "chrome",
    "vendor": "google",
    "weaknesses": 38,
    "publicExploit": false,
    "activeAlert": false,
    "exposedMachines": 5,
    "impactScore": 3.94418621
}