Obter recomendações por ID

Aplica-se a:

Quer experimentar o Microsoft Defender para Endpoint? Inscreva-se numa versão de avaliação gratuita.

Nota

Se for um cliente do Governo dos E.U.A., utilize os URIs listados no Microsoft Defender para o Endpoint para clientes do Governo dos EUA.

Dica

Para um melhor desempenho, pode utilizar o servidor mais perto 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 referem-se a produtos pré-lançados que podem ser modificados substancialmente antes do seu lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, relativamente às informações aqui fornecidas.

Recupera uma recomendação de segurança pelo seu ID.

Permissões

É necessária uma das seguintes permissões para chamar esta API. Para saber mais, incluindo como escolher permissões, consulte Utilizar o Microsoft Defender para APIs de Pontos Finais para obter detalhes.

Tipo de permissão Permissão Nome a apresentar da permissão
Aplicação SecurityRecommendation.Read.All "Ler informações de recomendação sobre a segurança de Gestão de Ameaças e Vulnerabilidades"
Delegado (conta escolar ou escolar) SecurityRecommendation.Read "Ler informações de recomendação sobre a segurança de Gestão de Ameaças e Vulnerabilidades"

Pedido HTTP

GET /api/recommendations/{id}

Pedir cabeçalhos

Name Tipo Descrição
Autorização Cadeia Bearer {token}. Obrigatório.

Pedir corpo

Vazio

Resposta

Se for bem-sucedido, este método devolve 200 OK com as recomendações de segurança no corpo.

Exemplos:

Exemplo de pedido

Eis um exemplo do pedido.

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

Exemplo de resposta

Eis um exemplo da resposta.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations/$entity",
    "id": "va-_-google-_-chrome",
    "productName": "chrome",
    "recommendationName": "Update Chrome",
    "weaknesses": 38,
    "vendor": "google",
    "recommendedVersion": "",
    "recommendationCategory": "Application",
    "subCategory": "",
    "severityScore": 0,
    "publicExploit": false,
    "activeAlert": false,
    "associatedThreats": [],
    "remediationType": "Update",
    "status": "Active",
    "configScoreImpact": 0,
    "exposureImpact": 3.9441860465116285,
    "totalMachineCount": 6,
    "exposedMachinesCount": 5,
    "nonProductivityImpactedAssets": 0,
    "relatedComponent": "Chrome"
}