Remover API de restrição de aplicações

Descrição da API

Ative a execução de qualquer aplicação no dispositivo.

Ao isolar um dispositivo, só são permitidos determinados processos e destinos. Os dispositivos que estão atrás de um túnel VPN completo não conseguirão aceder ao serviço cloud Microsoft Defender para Endpoint depois de o dispositivo estar isolado. Recomendamos a utilização de uma VPN de túnel dividido para Microsoft Defender para Endpoint e Microsoft Defender tráfego relacionado com a proteção baseada na cloud do Antivírus.

Limitações

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

Pré-requisitos

Sistemas operativos suportados

• O isolamento total está disponível para dispositivos no Windows 10, versão 1703.
• O isolamento seletivo está disponível para dispositivos no Windows 10, versão 1709 ou posterior.

Permissões

Ao obter um token com credenciais de utilizador:

• O utilizador tem de ter, pelo menos, a seguinte permissão de função: "Ações de remediação ativas". Para obter mais informações, veja: Criar e gerir funções
• O utilizador tem de ter acesso ao dispositivo, com base nas definições do grupo de dispositivos. Para obter mais informações, veja: Criar e gerir grupos de dispositivos

É necessária uma das seguintes permissões para chamar esta API. Para saber mais, incluindo como escolher permissões, veja Utilizar Microsoft Defender para Endpoint APIs

Tipo de permissão	Permissão	Nome a apresentar da permissão
Aplicação	Machine.RestrictExecution	"Restringir a execução de código"
Delegado (conta escolar ou profissional)	Machine.RestrictExecution	"Restringir a execução de código"

Pedido HTTP

POST https://api.security.microsoft.com/api/machines/{id}/unrestrictCodeExecution

Cabeçalhos de pedido

Name	Tipo	Descrição
Autorização	Cadeia	Portador {token}. Obrigatório.
Tipo de Conteúdo	cadeia	application/json. Obrigatório.

Corpo do pedido

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

Parâmetro	Tipo	Descrição
Comentar	Cadeia	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 enviar várias chamadas à API para remover restrições de aplicações para o mesmo dispositivo, devolve "ação de máquina pendente" ou HTTP 400 com a mensagem "A ação já está em curso".

Exemplos:

Pedido

Eis um exemplo do pedido.

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/unrestrictCodeExecution

{
  "Comment": "Unrestrict code execution since machine was cleaned and validated"
}