Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Descrição da API
Exclusão do dispositivo do Defender para Endpoint.
Pré-requisitos
Sistemas operacionais com suporte
| Sistema operacional | Versões suportadas |
|---|---|
| Cliente Windows | Windows 11 e Windows 10, versão 1703 e posteriores |
| Servidor Windows | Windows Server 2019 e versões posteriores; Windows Server 2012 R2 e Windows Server 2016 ao usar o novo agente unificado para Defender for Endpoint |
| macOS | macOS 14 e versões posteriores |
| Linux | Distribuições de Linux suportadas |
Limitações
- As limitações de taxa para esta API são 100 chamadas por minuto e 1500 chamadas por hora.
- Em dispositivos Windows, executar a API de offboarding só para o serviço de sensores. Ele não remove as informações de onboarding do registro como um script de offboarding.
Permissões
A Microsoft recomenda que você use funções com o menor número de permissões. Isto ajuda a melhorar a segurança da sua organização. O Administrador Global é uma função altamente privilegiada que deve ser limitada a cenários de emergência quando não for possível usar uma função existente.
Ao obter um token com credenciais de utilizador:
O utilizador tem de ter uma função adequada atribuída. Para obter mais informações, consulte: Opções de permissão.
O utilizador tem de ter acesso ao dispositivo, com base nas definições do grupo de dispositivos. Para obter mais informações, consulte: Criar e gerir grupos de dispositivos.
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.Offboard |
Offboard machine |
| Delegado (conta corporativa ou de estudante) | Machine.Offboard |
Offboard machine |
solicitação HTTP
POST https://api.security.microsoft.com/api/machines/{id}/offboard
O ID do computador pode ser encontrado no URL quando seleciona o dispositivo. Geralmente, é um número alfanumérico de 40 dígitos que pode ser encontrado no URL.
Cabeçalhos de solicitação
| Nome | Tipo | Descrição |
|---|---|---|
| Autorização | Cadeia de caracteres | {token} de portador. Obrigatório. |
| Content-Type | cadeia | 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 | Cadeia de caracteres | Comentário a associar à ação. Obrigatório. |
Resposta
Se for bem-sucedido, este método devolve 200 - Created response o código e a Ação da Máquina no corpo da resposta.
Exemplo
Solicitação
Eis um exemplo do pedido. Se não houver nenhum comentário JSON adicionado, erros com o código 400.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/offboard
{
"Comment": "Offboard machine by automation"
}