Obter a API de informações sobre incidentes
Aplica-se a:
Quer experimentar o Microsoft 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.
Gorjeta
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
Nota
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.
Obtém um incidente específico pelo respetivo ID
- As limitações de taxa para esta API são 100 chamadas por minuto e 1500 chamadas por hora.
É necessária uma das seguintes permissões para chamar esta API.
Tipo de permissão | Permissão | Nome a apresentar da permissão |
---|---|---|
Aplicação | Incident.Read.All | Read all Incidents |
Aplicação | Incident.ReadWrite.All | Read and write all Incidents |
Delegado (conta escolar ou profissional) | Incident.Read | Read Incidents |
Delegado (conta escolar ou profissional) | Incident.ReadWrite | Read and write Incidents |
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
- A resposta incluirá apenas incidentes aos quais o utilizador está exposto
GET .../api/incidents/{id}
Name | Tipo | Descrição |
---|---|---|
Autorização | Cadeia | Portador {token}. Obrigatório. |
Vazio
Se for bem-sucedido, este método devolve 200 OK
e a entidade do incidente no corpo da resposta.
Se o incidente com o ID especificado não tiver sido encontrado – 404 Não Encontrado.
Eis um exemplo do pedido.
GET https://api.security.microsoft.com/api/incidents/{id}
Utilizar a API de segurança do Microsoft Graph – Microsoft Graph | Microsoft Learn
Gorjeta
Quer saber mais? Interaja com a comunidade do Microsoft Security na nossa Tech Community: Microsoft Defender XDR Tech Community.