Supprimer une pièce jointe

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Supprimer une pièce jointe d’un événement, d’un message, d’une note, d’une tâche Outlook ou d’une publication de calendrier utilisateur.

Attention

Les tâches Outlook sont déconseillées et ne retournent plus de données le 10 août 2022. Mettez à jour les applications existantes qui utilisent cette fonctionnalité avec les tâches Outlook.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Selon la ressource (événement, message, note, outlookTask ou publication) à laquelle la pièce jointe est attachée et le type d’autorisation (délégué ou application) demandé, l’autorisation spécifiée dans le tableau suivant est la moins privilégiée requise pour appeler cette API. Pour en savoir plus, notamment sur les Mesures de prudence avant de choisir des autorisations plus privilégiées, recherchez ces autorisations dans Autorisations.

Ressource prise en charge Déléguée (compte professionnel ou scolaire) Déléguée (compte Microsoft personnel) Application
event Calendars.ReadWrite Calendars.ReadWrite Calendars.ReadWrite
message Mail.ReadWrite Mail.ReadWrite Mail.ReadWrite
Note ShortNotes.ReadWrite ShortNotes.ReadWrite ShortNotes.ReadWrite.All
outlookTask Tasks.ReadWrite Tasks.ReadWrite Non pris en charge
post Group.ReadWrite.All Non pris en charge Non pris en charge

Requête HTTP

Pièces jointes à un événement dans le calendrier par défaut de l’utilisateur.

DELETE /me/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/events/{id}/attachments/{id}

DELETE /me/calendar/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendar/events/{id}/attachments/{id}

Pièces jointes pour un événement dans le calendrier spécifié qui appartient à l’utilisateur.

DELETE /me/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}

Pièces jointes pour un événement dans un calendrier qui appartient au calendarGroup par défaut de l’utilisateur.

DELETE /me/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}

Pièces jointes pour un événement dans un calendrier qui appartient au calendarGroup d’un utilisateur.

DELETE /me/calendarGroups/{id}/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}/attachments/{id}

Pièces jointes pour un élément message dans la boîte aux lettres d’un utilisateur.

DELETE /me/messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/messages/{id}/attachments/{id}

Pièces jointes pour un élément message contenu dans un élément mailFolder de niveau supérieur dans la boîte aux lettres d’un utilisateur.

DELETE /me/mailFolders/{id}/messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/attachments/{id}

Pièces jointes pour un message contenu dans un dossier enfant d’un dossier de courrier dans la boîte aux lettres d’un utilisateur. L’exemple suivant montre un niveau d’imbrication, mais un message peut se trouver dans un enfant d’un enfant, etc.

DELETE /me/mailFolders/{id}/childFolders/{id}/.../messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/childFolders/{id}/messages/{id}/attachments/{id}

Pièces jointes pour une note dans la boîte aux lettres d’un utilisateur.

DELETE /me/notes/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/notes/{id}/attachments/{id}

Pièces jointes pour une tâche Outlook.

DELETE /me/outlook/tasks/{id}/attachments/{id}
DELETE /users/{id}/outlook/tasks/{id}/attachments/{id}

Pièces jointes pour un billet dans un thread qui appartient à une conversation d’un groupe.

DELETE /groups/{id}/threads/{id}/posts/{id}/attachments/{id}
DELETE /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments/{id}

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

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. Il ne retourne rien dans le corps de la réponse.

Exemples

Exemple 1 : Supprimer une pièce jointe d’événement

L’exemple suivant montre comment supprimer une pièce jointe sur un événement.

Demande

L’exemple suivant illustre une demande.

DELETE https://graph.microsoft.com/beta/me/events/{id}/attachments/{id}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content

Exemple 2 : Supprimer une pièce jointe de note

L’exemple suivant montre comment supprimer une pièce jointe sur une note.

Demande

L’exemple suivant illustre une demande.

DELETE https://graph.microsoft.com/beta/me/notes/AAMkAGI2THVSAAA=/attachments/AAMkAGI2attach2

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content