Delete a DriveItem

Espace de noms: microsoft.graph

Supprimer un objet DriveItem par l’intermédiaire de son ID ou de son chemin d’accès. La suppression d’éléments à l’aide de cette méthode déplace les éléments vers la Corbeille au lieu de supprimer définitivement l’élément.

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

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Files.ReadWrite Files.ReadWrite.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.ReadWrite Files.ReadWrite.All
Application Files.ReadWrite.All Sites.ReadWrite.All

Requête HTTP

DELETE /drives/{drive-id}/items/{item-id}
DELETE /groups/{group-id}/drive/items/{item-id}
DELETE /me/drive/items/{item-id}
DELETE /sites/{siteId}/drive/items/{itemId}
DELETE /users/{userId}/drive/items/{itemId}

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
if-match Chaîne. Si cet en-tête de demande est inclus et que l’eTag (ou cTag) fourni ne correspond pas à la balise actuelle de l’élément, une 412 Precondition Failed réponse est retournée et l’élément n’est pas supprimé.

Exemple

Voici un exemple d’appel de cette API.

DELETE https://graph.microsoft.com/v1.0/me/drive/items/{item-id}

Réponse

S’il réussit, cet appel renvoie une réponse 204 No Content pour indiquer que la ressource a été supprimée et qu’il n’y a rien à renvoyer.

HTTP/1.1 204 No Content

Réponses d’erreur

Pour plus d’informations sur la façon dont les erreurs sont renvoyées, voir Réponses d’erreur.