Obter pontuação de exposição

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 o resultado da exposição organizacional.

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

Tipo de permissão Permissão Nome a apresentar da permissão
Aplicação Score.Read.All 'Ler pontuação de Gestão de Ameaças e Vulnerabilidades'
Delegado (conta escolar ou escolar) Score.Read 'Ler pontuação de Gestão de Ameaças e Vulnerabilidades'

Pedido HTTP

GET /api/exposureScore

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 os dados de exposição no corpo da resposta.

Exemplos:

Pedir

Eis um exemplo do pedido.

GET https://api.securitycenter.microsoft.com/api/exposureScore

Resposta

Eis um exemplo da resposta.

Nota

A lista de respostas aqui apresentada poderá estar truncada por questão de brevidade.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ExposureScore/$entity",
    "time": "2019-12-03T07:23:53.280499Z",
    "score": 33.491554051195706
}

Consulte também