APIs suportadas pelo Microsoft Defender para Endpoint
Aplica-se a:
- API do Microsoft Defender para Endpoint 1
- Microsoft Defender para Endpoint Plano 2
- Microsoft Defender para Empresas
Importante
As capacidades avançadas de investigação não estão incluídas no Defender para Empresas.
Quer experimentar o Microsoft Defender para Ponto Final? Inscrever-se para uma avaliação gratuita.
URI e controlo de versões do ponto final
URI do ponto final
O URI da base de serviço é: https://api.security.microsoft.com
O OData baseado em consultas tem o prefixo "/api". Por exemplo, para obter Alertas, pode enviar um pedido GET para https://api.security.microsoft.com/api/alerts
Controlo de versões
A API suporta o controlo de versões.
A versão atual é V1.0. Para utilizar uma versão específica, utilize este formato:
https://api.security.microsoft.com/api/{Version}. Por exemplo:https://api.security.microsoft.com/api/v1.0/alertsSe não especificar nenhuma versão (por exemplo
https://api.security.microsoft.com/api/alerts, ) irá aceder à versão mais recente.
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
- ina.api.security.microsoft.com
Saiba mais sobre as entidades suportadas individuais onde pode executar chamadas à API e detalhes, como valores de pedido HTTP, cabeçalhos de pedido e respostas esperadas.
Nesta secção
| Tópico | Descrição |
|---|---|
| Métodos de Investigação Avançada | Execute consultas a partir da API. |
| Métodos e propriedades de alerta | Execute chamadas à API, como : obter alertas, criar alertas, atualizar alertas e muito mais. |
| Exportar métodos e propriedades de Avaliação por dispositivo | Execute chamadas à API para recolher avaliações de vulnerabilidades por dispositivo, tais como: - exportar avaliação de configuração segura, exportar avaliação de inventário de software, exportar avaliação de vulnerabilidades de software e avaliação de vulnerabilidades de software de exportação delta. |
| Métodos e propriedades de investigação automatizados | Execute chamadas à API, como : obter a recolha de Investigação. |
| Exportar métodos e propriedades do estado de funcionamento do dispositivo | Execute Chamadas à API, como - GET /api/public/avdeviceshealth. |
| Alertas relacionados com domínios | Execute chamadas à API, como : obter dispositivos relacionados com o domínio, estatísticas de domínio e muito mais. |
| Métodos e propriedades de ficheiros | Execute chamadas à API, como : obter informações de ficheiro, alertas relacionados com ficheiros, dispositivos relacionados com ficheiros e estatísticas de ficheiros. |
| Métodos e propriedades de indicadores | Execute uma chamada à API, como : obter Indicadores, criar Indicador e eliminar Indicadores. |
| Alertas relacionados com IP | Execute chamadas à API, como : obter alertas relacionados com o IP e obter estatísticas de IP. |
| Métodos e propriedades da máquina | Execute chamadas à API, como : obter dispositivos, obter dispositivos por ID, informações sobre utilizadores com sessão iniciada, editar etiquetas e muito mais. |
| Métodos e propriedades da Ação da Máquina | Execute uma chamada à API, como Isolamento, Executar análise antivírus e muito mais. |
| Métodos e propriedades de recomendação | Execute chamadas à API, como : obter recomendação por ID. |
| Métodos e propriedades da atividade de remediação | Execute uma chamada à API, como : obter todas as tarefas de remediação, expor a tarefa de remediação de dispositivos e obter uma tarefa de remediação por ID. |
| Métodos e propriedades de classificação | Execute chamadas à API, como : obtenha a classificação de exposição ou obtenha a classificação de segurança do dispositivo. |
| Métodos e propriedades de software | Execute chamadas à API, tais como - listar vulnerabilidades por software. |
| Métodos e propriedades do utilizador | Execute chamadas à API, como : obter alertas relacionados com o utilizador e dispositivos relacionados com o utilizador. |
| Métodos e propriedades de vulnerabilidades | Execute chamadas à API, como - listar dispositivos por vulnerabilidade. |
Consulte também
Sugestão
Quer saber mais? Contacte a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Endpoint Tech Community.