Eliminar elemento del buzón

Espacio de nombres: microsoft.graph

Eliminar un elemento de buzón de un buzónCarpeta en un buzón.

Use el parámetro de consulta disposalType para especificar si se eliminará el elemento mediante una eliminación temporal o permanente.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) MailboxItem.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación MailboxItem.ReadWrite.All No disponible.

Solicitud HTTP

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

Parámetros de consulta

En la dirección URL de la solicitud, proporcione el siguiente parámetro de consulta obligatorio.

Parámetro Tipo Description
disposalType Cadena Obligatorio. Tipo de operación de eliminación que se va a realizar. Los valores posibles son: softDelete, hardDelete. Se usa softDelete para seguir la semántica de eliminación temporal de Exchange o hardDelete para eliminar permanentemente el elemento.

Encabezados de solicitud

Nombre Descripción
Autorización Obligatorio. Obtenga más información sobre autenticación y autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Nota:

Cuando se usa hardDelete, el servicio de Exchange elimina permanentemente el elemento solo cuando se trata de datos de clientes que no están protegidos por una suspensión legal, una directiva de retención, una auditoría, un cumplimiento o una restricción de elementos del sistema. De lo contrario, se produce un 403 Forbidden error en la solicitud.

Ejemplos

Ejemplo 1: Eliminar temporalmente un elemento de buzón

En el ejemplo siguiente se muestra cómo eliminar un elemento del buzón de una carpeta mediante disposalType=softDelete.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 2: Eliminar de forma permanente un elemento de buzón

En el ejemplo siguiente se muestra cómo eliminar de forma permanente un elemento de buzón apto en Elementos recuperables mediante disposalType=hardDelete.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content
  • Last updated on