Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Eliminar um objeto agentUser .
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissão com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | AgentIdUser.ReadWrite.IdentityParentedBy | AgentIdUser.ReadWrite.All, User.DeleteRestore.All, User.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | AgentIdUser.ReadWrite.IdentityParentedBy | AgentIdUser.ReadWrite.All, User.DeleteRestore.All, User.ReadWrite.All |
Importante
Tem de ser atribuída ao utilizador de chamada, pelo menos, uma das seguintes funções de Microsoft Entra:
- Administrador do usuário
- Administrador de Autenticação Privilegiada
- Administrador de ID do Agente
Para eliminar utilizadores com funções de administrador com privilégios em cenários delegados, tem de ser atribuída a permissão Directory.AccessAsUser.All delegated e o utilizador de chamada tem de ter uma função de administrador com privilégios superior, conforme indicado em Quem pode realizar ações confidenciais.
Em cenários apenas de aplicações, a permissão User.ReadWrite.All application não é suficiente para eliminar utilizadores com funções administrativas com privilégios. Tem de ser atribuída ao agente uma função de administrador com privilégios superior, conforme indicado em Quem pode realizar ações confidenciais.
Solicitação HTTP
DELETE /users/microsoft.graph.agentUser/{userId}
Nota: um utilizador agente também pode ser eliminado através do ponto final dos utilizadores padrão: DELETE /users/userId. Não é necessário especificar nenhum tipo de odata especial no pedido.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No Content.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
DELETE https://graph.microsoft.com/beta/users/microsoft.graph.agentUser/ba9a3254-9f18-4209-aeb3-9e42a35b5be4
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content