Obter a 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 for um cliente do Us Government, utilize os URIs listados no Microsoft Defender para Endpoint 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.
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.
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
GET .../api/incidents/{id}
Nome | Tipo | Descrição |
---|---|---|
Autorização | Cadeia de caracteres | {token} de portador. 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
Dica
Você deseja aprender mais? Participe da comunidade de Segurança da Microsoft em nossa Tech Community: Tech Community do Microsoft Defender XDR.