Partilhar via

Obter API de alertas relacionados com IP

  • Artigo

Aplica-se a:

Quer experimentar o Defender para Ponto Final? Inscrever-se para uma avaliação gratuita.

Nota

Se for um cliente do Us Government, utilize os URIs listados no Microsoft Defender para Endpoint para clientes do Us Government.

Sugestão

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

Descrição da API

Obtém uma coleção de alertas relacionados com um determinado endereço IP.

Limitações

  1. As limitações de taxa para esta API são 100 chamadas por minuto e 1500 chamadas por hora.

Permissões

É necessária uma das seguintes permissões para chamar esta API. Para saber mais, incluindo como escolher permissões, veja Utilizar as APIs do Defender para Endpoint.

Tipo de permissão Permissão Nome a apresentar da permissão
Aplicação Alert.Read.All Read all alerts
Aplicação Alert.ReadWrite.All Read and write all alerts
Delegado (conta escolar ou profissional) Alert.Read Read alerts
Delegado (conta escolar ou profissional) Alert.ReadWrite Read and write alerts

Nota

Ao obter um token com credenciais de utilizador:

  • O utilizador tem de ter, pelo menos, a seguinte permissão de função: View Data. Para obter mais informações, veja Create e gerir funções para obter mais informações.
  • A resposta inclui apenas alertas, associados a dispositivos, aos quais o utilizador tem acesso, com base nas definições do grupo de dispositivos (consulte Create e gerir grupos de dispositivos para obter mais informações)

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

Pedido HTTP

GET /api/ips/{ip}/alerts

Cabeçalhos de pedido

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

Corpo do pedido

Vazio

Resposta

Se tiver êxito e o IP existir – 200 OK com a lista de entidades de alerta no corpo. Se o endereço IP for desconhecido, mas for válido, devolve um conjunto vazio. Se o endereço IP for inválido, devolve HTTP 400.

Exemplos:

Pedido

Eis um exemplo do pedido.

GET https://api.securitycenter.microsoft.com/api/ips/10.209.67.177/alerts

Sugestão

Quer saber mais? Engage com a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Endpoint Tech Community.