Share via


Obter API de informações sobre incidentes

Aplica-se a:

Deseja experimentar o Microsoft Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita.

Observação

Se você for um cliente do governo dos EUA, use as URIs listadas em Microsoft Defender para Ponto de Extremidade para clientes do governo dos EUA.

Dica

Para obter um melhor desempenho, você pode usar 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

Observação

Experimente nossas novas APIs usando a API de segurança do MS Graph. Saiba mais em: Usar a API de segurança do Microsoft Graph – Microsoft Graph | Microsoft Learn.

Descrição da API

Recupera um incidente específico por sua ID

Limitações

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

Permissões

Uma das seguintes permissões é necessária para chamar esta API.

Tipo de permissão Permissão Nome da exibição de permissão
Application Incident.Read.All Read all Incidents
Application Incident.ReadWrite.All Read and write all Incidents
Delegado (conta corporativa ou de estudante) Incident.Read Read Incidents
Delegado (conta corporativa ou de estudante) Incident.ReadWrite Read and write Incidents

Observação

Ao obter um token usando credenciais de usuário:

  • O usuário precisa ter pelo menos a seguinte permissão de função: View Data
  • A resposta incluirá apenas incidentes aos quais o usuário é exposto

Solicitação HTTP

GET .../api/incidents/{id}

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 for bem-sucedido, esse método retornará 200 OKe a entidade de incidente no corpo da resposta. Se o incidente com a ID especificada não tiver sido encontrado – 404 Não encontrado.

Exemplo

Solicitação

Aqui está um exemplo da solicitação.

GET https://api.security.microsoft.com/api/incidents/{id}

Usar a API de segurança do Microsoft Graph – Microsoft Graph | Microsoft Learn

Dica

Você deseja aprender mais? Engage com a comunidade de Segurança da Microsoft em nossa Comunidade Tecnológica: Microsoft Defender XDR Tech Community.