Excluir mailboxItem

Namespace: microsoft.graph

Excluir um mailboxItem de uma pasta mailbox em uma caixa de correio.

Use o parâmetro de consulta disposalType para especificar se deseja excluir temporariamente ou irreversivelmente o item.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão	Permissões menos privilegiadas	Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante)	MailboxItem.ReadWrite	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	MailboxItem.ReadWrite.All	Indisponível.

Solicitação HTTP

DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/{mailboxItemId}?disposalType={disposalType}

Parâmetros de consulta

Na URL da solicitação, forneça o seguinte parâmetro de consulta necessário.

Parâmetro	Tipo	Descrição
disposalType	Cadeia de caracteres	Obrigatório. O tipo de operação de exclusão a ser executada. Os valores possíveis são: softDelete, hardDelete. Use softDelete para seguir a semântica de exclusão reversível do Exchange ou hardDelete para excluir permanentemente o item.

Cabeçalhos de solicitação

Nome	Descrição
Authorization	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.

Observação

Quando você usa hardDeleteo , o serviço do Exchange exclui permanentemente o item somente quando são dados do cliente que não estão protegidos por uma retenção legal, política de retenção, auditoria, conformidade ou restrição de item do sistema. Caso contrário, a solicitação falhará com um 403 Forbidden erro.

Exemplos

Exemplo 1: excluir temporariamente um item de caixa de correio

O exemplo a seguir mostra como excluir temporariamente um item de caixa de correio em uma pasta usando disposalType=softDelete.

Solicitação

O exemplo a seguir mostra uma solicitação.

DELETE https://graph.microsoft.com/v1.0/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/inbox/items/AAMkADk0MzI?disposalType=softDelete

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: excluir irreversivelmente um item de caixa de correio

O exemplo a seguir mostra como excluir irreversivelmente um item de caixa de correio qualificado em Itens Recuperáveis usando disposalType=hardDelete.

Solicitação

O exemplo a seguir mostra uma solicitação.

DELETE https://graph.microsoft.com/v1.0/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/recoverableitemsdeletions/items/AAMkADk0MzI?disposalType=hardDelete

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content