Compartilhar via

Obter a API de informações sobre incidentes

  • Artigo
  • Aplica-se a: Microsoft Defender XDR

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

Observação

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

Descrição da API

Obtém um incidente específico pelo respetivo ID

Limitações

  1. 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.

Tipo de permissão Permissão Nome a apresentar da 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 com credenciais de utilizador:

  • O utilizador tem de ter, pelo menos, a seguinte permissão de função: View Data
  • A resposta incluirá apenas incidentes aos quais o utilizador está 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, este método devolve 200 OKe a entidade do incidente no corpo da resposta. Se o incidente com o ID especificado não tiver sido encontrado – 404 Não Encontrado.

Exemplo

Solicitação

Eis um exemplo do pedido.

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

Conteúdo relacionado

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

Dica

Você deseja aprender mais? Participe da comunidade de Segurança da Microsoft em nossa Tech Community: Tech Community do Microsoft Defender XDR.