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 userPrincipalNamepropriedades , maile proxyAddresses de users com referências ao domínio eliminado para utilizar o domínio de onmicrosoft.com inicial.

  • Atualizações a mail propriedade de groups com referências ao domínio eliminado para utilizar o domínio de onmicrosoft.com inicial.

  • Atualizações a identifierUris propriedade de applications 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