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 Microsoft Defender para Ponto de Extremidade para clientes do Governo dos EUA.

Ponta

Para obter um melhor desempenho, você pode usar o servidor mais próximo da 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 permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, consulte Usar Microsoft Defender para Ponto de Extremidade APIs para obter detalhes.

Tipo de permissão Permissão Nome de exibição da permissão
Application 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 Cadeia de caracteres Portador {token}. Obrigatório.

Corpo da solicitação

Vazio

Resposta

Se bem-sucedido, 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
}