Compartilhar via

Obter a API de informações de domínio relacionadas com alertas

  • Artigo

Aplica-se a:

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

Descrição da API

Obtém todos os domínios relacionados com um alerta específico.

Limitações

  1. Pode consultar os alertas atualizados pela última vez de acordo com o período de retenção configurado.
  2. As limitações de taxa para esta API são 100 chamadas por minuto e 1500 chamadas por hora.

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 URL. Read.All "URLs de Leitura"
Delegado (conta corporativa ou de estudante) URL. Read.All "URLs de Leitura"

Observação

Ao obter um token com credenciais de utilizador:

  • O utilizador tem de ter, pelo menos, a seguinte permissão de função: "Ver Dados" (Para obter mais informações, consulte Criar e gerir funções)
  • O utilizador precisa de ter acesso ao dispositivo associado ao alerta, com base nas definições do grupo de dispositivos (para obter mais informações, consulte Criar e gerir grupos de dispositivos)

A criação de grupos de dispositivos é suportada no Defender para Endpoint Plano 1 e Plano 2.

Solicitação HTTP

GET /api/alerts/{id}/domains

Cabeçalhos de solicitação

Nome Tipo Descrição
Autorização Cadeia de caracteres {token} de portador. Obrigatório.

Corpo da solicitação

Vazio

Resposta

Se tiver êxito, o alerta e o domínio existem – 200 OK. Se o alerta não for encontrado – 404 Não Encontrado.

Exemplo

Solicitação

Eis um exemplo do pedido.

GET https://api.securitycenter.microsoft.com/alerts/636688558380765161_2136280442/domains

Exemplo de resposta

Veja um exemplo de resposta.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/$metadata#Domains",
    "value": [
        {
            "host": "www.example.com"
        },
        {
            "host": "www.example2.com"
        }
        ...
    ]
}

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.