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.