domínio: forceDelete
Namespace: microsoft.graph
Elimine um domínio com uma operação assíncrona de execução prolongada.
Antes de efetuar esta operação, tem de atualizar ou remover quaisquer referências ao Exchange como o serviço de aprovisionamento.
As seguintes ações são executadas como parte desta operação:
Atualizações as
userPrincipalName
propriedades ,mail
eproxyAddresses
deusers
com referências ao domínio eliminado para utilizar o domínio de onmicrosoft.com inicial.Atualizações a
mail
propriedade degroups
com referências ao domínio eliminado para utilizar o domínio de onmicrosoft.com inicial.Atualizações a
identifierUris
propriedade deapplications
com referências ao domínio eliminado para utilizar o domínio de onmicrosoft.com inicial.Se o número de objetos cujo nome é superior a 1000, é devolvido um erro.
Se um dos nomes a mudar for uma aplicação
applications
multi-inquilino, é devolvido um erro.
Após a eliminação do domínio ser concluída, as operações de API para o domínio eliminado devolvem um código de status HTTP 404. Para verificar a eliminação de um domínio, pode executar uma operação obter domínio .
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
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ões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | Domain.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Domain.ReadWrite.All | Indisponível. |
Importante
Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. O Administrador de Nome de Domínio é a função com menos privilégios suportada para esta operação.
Solicitação HTTP
POST /domains/{id}/forceDelete
Para {id}, especifique o domínio com seu nome de domínio totalmente qualificado.
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Content-Type | application/json |
Corpo da solicitação
Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.
Parâmetro | Tipo | Descrição |
---|---|---|
disableUserAccounts |
Boolean |
Opção para desativar as contas de utilizador cujo nome foi mudado. Se uma conta de utilizador estiver desativada, o utilizador não tem permissão para iniciar sessão. Se definido para true os utilizadores atualizados como parte desta operação, estão desativados. O valor padrão é true . |
Corpo da resposta
Se for bem-sucedido, este método devolve HTTP/1.1 204 OK
status código.
Exemplo
Solicitação
POST https://graph.microsoft.com/v1.0/domains/{id}/forceDelete
Content-type: application/json
{
"disableUserAccounts": true
}
Resposta
HTTP/1.1 204 OK