Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Supprimer un élément de boîte aux lettres d’un dossier de boîte aux lettres dans une boîte aux lettres.
Utilisez le paramètre de requête disposalType pour spécifier s’il faut supprimer l’élément de manière réversible ou définitive.
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.
| Type d’autorisation | Autorisations les moins privilégiées | Autorisations à privilèges plus élevés |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | MailboxItem.ReadWrite | Non disponible. |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | MailboxItem.ReadWrite.All | Non disponible. |
Requête HTTP
DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/{mailboxItemId}?disposalType={disposalType}
Paramètres de requête
Dans l’URL de demande, indiquez le paramètre de requête requis suivant.
| Paramètre | Type | Description |
|---|---|---|
| disposalType | String | Obligatoire. Type d’opération de suppression à effectuer. Les valeurs possibles sont : softDelete, hardDelete. Permet softDelete de suivre la sémantique de suppression réversible d’Exchange ou hardDelete de supprimer définitivement l’élément. |
En-têtes de demande
| Nom | Description |
|---|---|
| Autorisation | Obligatoire. En savoir plus sur l’authentification et les autorisations. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.
Remarque
Lorsque vous utilisez hardDelete, le service Exchange supprime définitivement l’élément uniquement lorsqu’il s’agit de données client qui ne sont pas protégées par une conservation légale, une stratégie de rétention, un audit, une conformité ou une restriction d’élément système. Dans le cas contraire, la demande échoue avec une 403 Forbidden erreur.
Exemples
Exemple 1 : Suppression réversible d’un élément de boîte aux lettres
L’exemple suivant montre comment supprimer de manière réversible un élément de boîte aux lettres dans un dossier à l’aide disposalType=softDeletede .
Demande
L’exemple suivant illustre une demande.
DELETE https://graph.microsoft.com/v1.0/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/inbox/items/AAMkADk0MzI?disposalType=softDelete
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 204 No Content
Exemple 2 : suppression définitive d’un élément de boîte aux lettres
L’exemple suivant montre comment supprimer définitivement un élément de boîte aux lettres éligible dans Éléments récupérables à l’aide disposalType=hardDeletede .
Demande
L’exemple suivant illustre une demande.
DELETE https://graph.microsoft.com/v1.0/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/recoverableitemsdeletions/items/AAMkADk0MzI?disposalType=hardDelete
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 204 No Content