Restaurar item excluído

Namespace: microsoft.graph

Restaura um item recentemente excluído de itens excluídos.

Atualmente, a funcionalidade de restaurar itens excluídos só tem suporte para recursos de aplicativo, servicePrincipal, grupo e usuário . Se um item foi excluído acidentalmente, você poderá restaurá-lo totalmente. Isso não se aplica a grupos de segurança, que são excluídos permanentemente.

Um item recentemente excluído permanecerá disponível por até 30 dias. Após 30 dias, esse item será excluído permanentemente.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Para aplicativos e entidades de serviço:

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Application.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Application.ReadWrite.OwnedBy, Application.ReadWrite.All

Para usuários:

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) User.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo User.ReadWrite.All

Para grupos:

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Group.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Group.ReadWrite.All

Solicitação HTTP

POST /directory/deletedItems/{id}/restore

Cabeçalhos de solicitação

Nome Descrição
Autorização Token de <portador> obrigatório
Content-type 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 200 OK e um objeto directoryObject no corpo da resposta.

Exemplo

Solicitação

POST https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}/restore

Resposta

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

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#directoryObjects/$entity",
  "@odata.type":"#microsoft.graph.group",
  "id":"46cc6179-19d0-473e-97ad-6ff84347bbbb",
  "displayName":"SampleGroup",
  "groupTypes":["Unified"],
  "mail":"example@contoso.com",
  "mailEnabled":true,
  "mailNickname":"Example",
  "securityEnabled":false,
  "visibility":"Public"
}