Listar API de Investigações

Artigo
02/20/2025

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

Descrição da API

Obtém uma coleção de Investigações.

Suporta consultas OData V4.

A consulta do $filter OData é suportada em: startTime, id, state, machineIde triggeringAlertId propriedades.
$stop com o valor máximo de 10 000
$skip

Veja exemplos em Consultas OData com Microsoft Defender para Ponto de Extremidade

Limitações

O tamanho máximo da página é 10 000.
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. Para saber mais, incluindo como escolher permissões, veja Utilizar Microsoft Defender para Ponto de Extremidade APIs.

Tipo de permissão	Permissão	Nome a apresentar da permissão
Application	Alert.Read.All	`Read all alerts`
Application	Alert.ReadWrite.All	`Read and write all alerts`
Delegado (conta corporativa ou de estudante)	Alert.Read	`Read alerts`
Delegado (conta corporativa ou de estudante)	Alert.ReadWrite	`Read and write alerts`

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. Para obter mais informações, consulte Criar e gerir funções para obter mais informações.

Solicitação HTTP

GET https://api.securitycenter.microsoft.com/api/investigations

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 código de resposta OK com uma coleção de entidades de Investigações .

Exemplo

Exemplo de solicitação

Eis um exemplo de um pedido para obter todas as investigações:

GET https://api.securitycenter.microsoft.com/api/investigations

Exemplo de resposta

Eis um exemplo da resposta:

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Investigations",
    "value": [
        {
            "id": "63017",
            "startTime": "2020-01-06T14:11:34Z",
            "endTime": null,
            "state": "Running",
            "cancelledBy": null,
            "statusDetails": null,
            "machineId": "a69a22debe5f274d8765ea3c368d00762e057b30",
            "computerDnsName": "desktop-gtrcon0",
            "triggeringAlertId": "da637139166940871892_-598649278"
        }
        ...
    ]
}