Recolher a API do pacote de investigação

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

Recolha o pacote de investigação de um dispositivo.

Limitações

As limitações de taxa para esta API são 100 chamadas por minuto e 1500 chamadas por hora.

Importante

Estas ações de resposta só estão disponíveis para dispositivos em Windows 10, versão 1703 ou posterior e em Windows 11.

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, veja Utilizar as APIs do Defender para Endpoint

Tipo de permissão	Permissão	Nome a apresentar da permissão
Application	Machine.CollectForensics	'Recolher peritos'
Delegado (conta corporativa ou de estudante)	Machine.CollectForensics	'Recolher peritos'

Observação

Ao obter um token com credenciais de utilizador:

O utilizador tem de ter, pelo menos, a seguinte permissão de função: "Investigação de Alertas" (consulte Criar e gerir funções para obter mais informações)
O utilizador precisa de ter acesso ao dispositivo, com base nas definições do grupo de dispositivos (consulte Criar e gerir grupos de dispositivos para obter mais informações)

A criação de grupos de dispositivos é suportada no Defender para Endpoint Plano 1 e Plano 2.

Solicitação HTTP

POST https://api.securitycenter.microsoft.com/api/machines/{id}/collectInvestigationPackage

Cabeçalhos de solicitação

Nome	Tipo	Descrição
Autorização	Cadeia de caracteres	{token} de portador. Obrigatório.
Content-Type	string	application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça um objeto JSON com os seguintes parâmetros:

Parâmetro	Tipo	Descrição
Comentário	String	Comentário a associar à ação. Obrigatório.

Resposta

Se for bem-sucedido, este método devolve 201 – Código de resposta criado e Ação automática no corpo da resposta. Se uma coleção já estiver em execução, devolve 400 Pedido Incorreto.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://api.securitycenter.microsoft.com/api/machines/fb9ab6be3965095a09c057be7c90f0a2/collectInvestigationPackage

{
  "Comment": "Collect forensics due to alert 1234"
}