Definir a API de valor do dispositivo

Aplica-se a: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

Descrição da API

Defina o valor do dispositivo de um Computador específico.
Veja Atribuir valores de dispositivo para obter mais informações.

Pode publicar em dispositivos vistos pela última vez de acordo com o período de retenção configurado.
As limitações de taxa para esta API são 100 chamadas por minuto e 1500 chamadas por hora.

Ao obter um token com credenciais de utilizador:

O utilizador tem de ter, pelo menos, a seguinte permissão de função: "Gerir definição de segurança". Para obter mais informações, veja Criar e gerir funções.
O utilizador precisa de ter acesso ao computador, com base nas definições do grupo de máquinas. Para obter mais informações, veja Criar e gerir grupos de máquinas.

É 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.ReadWrite.All	"Ler e escrever todas as informações do computador"
Delegado (conta escolar ou profissional)	Machine.ReadWrite	"Ler e escrever informações do computador"

POST https://api.security.microsoft.com/api/machines/{machineId}/setDeviceValue

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

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

Parâmetro	Tipo	Descrição
DeviceValue	Enumeração	Valor do dispositivo. Os valores permitidos são: "Normal", "Baixo" e "Alto". Obrigatório.

Se for bem-sucedido, este método devolve o código de resposta 200 - Ok e o Computador atualizado no corpo da resposta.

Eis um exemplo de um pedido que adiciona uma etiqueta de computador.

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

{
  "DeviceValue" : "High"
}

Esta página foi útil?