Eliminar permanentemente um item (objeto de diretório)

Namespace: microsoft.graph

Elimine permanentemente uma aplicação, grupo, servicePrincipal ou objeto deutilizador eliminados recentemente. Depois de um item ser eliminado permanentemente, não pode ser restaurado.

As unidades administrativas não podem ser eliminadas permanentemente com a API deletedItems . As unidades administrativas eliminadas de forma recuperável serão eliminadas permanentemente 30 dias após a eliminação inicial, a menos que sejam restauradas.

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

A tabela seguinte mostra as permissões ou permissões com menos privilégios necessárias para chamar esta API em cada tipo de recurso suportado. Siga as melhores práticas para pedir permissões com menos privilégios. 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.

Recurso com suporte Delegada (conta corporativa ou de estudante) Delegada (conta pessoal da Microsoft) Application
application Application.ReadWrite.All Sem suporte. Application.ReadWrite.OwnedBy
grupo Group.ReadWrite.All Sem suporte. Sem suporte.
servicePrincipal Application.ReadWrite.All Sem suporte. Application.ReadWrite.OwnedBy
user User.ReadWrite.All Sem suporte. Sem suporte.

Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função suportada do Microsoft Entra ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação.

  • Para eliminar permanentemente aplicações ou principais de serviço eliminados: Administrador de Aplicações, Administrador de Aplicações na Cloud ou Administrador de Identidade Híbrida.
  • Para eliminar permanentemente utilizadores eliminados: Administrador de Utilizadores.
  • Para eliminar permanentemente grupos eliminados: Administrador de Grupos.

Solicitação HTTP

DELETE /directory/deletedItems/{id}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem sucedido, este método retorna um código de resposta 204 No Content. Não devolve nada no corpo da resposta.

Exemplo

Solicitação
DELETE https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}
Resposta

Observação: o objeto de resposta exibido aqui pode ser encurtado para legibilidade.

HTTP/1.1 204 No Content