Compartilhar via


Classificação de exposição de lista por grupo de dispositivos

Aplica-se a:

Deseja experimentar o 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

Importante

Algumas informações neste artigo estão relacionadas ao produto pré-lançado que pode ser modificado substancialmente antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, com relação às informações aqui fornecidas.

Obtém a pontuação de exposição para cada grupo de máquinas.

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

Tipo de permissão Permissão Nome a apresentar da permissão
Application Score.Read.All "Ler a classificação de Gestão de Ameaças e Vulnerabilidades"
Delegado (conta corporativa ou de estudante) Score.Read "Ler a classificação de Gestão de Ameaças e Vulnerabilidades"

Solicitação HTTP

GET /api/exposureScore/ByMachineGroups

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 for bem-sucedido, este método devolve 200 OK, com uma lista de classificações de exposição por dados do grupo de dispositivos no corpo da resposta.

Exemplo

Exemplo de solicitação

Este é um exemplo da solicitação.

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

Resposta de exemplo

Veja a seguir um exemplo da resposta.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ExposureScore",
    "value": [
        {
            "time": "2019-12-03T09:51:28.214338Z",
            "score": 41.38041766305988,
            "rbacGroupName": "GroupOne"
        },
        {
            "time": "2019-12-03T09:51:28.2143399Z",
            "score": 37.403726933165366,
            "rbacGroupName": "GroupTwo"
        }
        ...
    ]
}

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.