driveItem : permanentDelete

Espace de noms: microsoft.graph

Supprimer définitivement un élément de lecteur à l’aide de son ID. Si vous supprimez des éléments à l’aide de cette méthode, ils sont définitivement supprimés et ne sont pas envoyés à la corbeille, contrairement à l’API Delete driveItem qui envoie l’élément à la corbeille. Par conséquent, les éléments de lecteur supprimés définitivement ne peuvent pas être restaurés par la suite.

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

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ✅

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) 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

Remarque

SharePoint Embedded nécessite l’autorisation FileStorageContainer.Selected pour accéder au contenu du conteneur. Cette autorisation est différente de celles mentionnées précédemment. Outre les autorisations Microsoft Graph, votre application doit disposer des autorisations de type conteneur nécessaires pour appeler cette API. Pour plus d’informations, consultez Authentification et autorisation SharePoint Embedded.

Requête HTTP

POST /drives/{drive-id}/items/{item-id}/permanentDelete

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Accepter application/json

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

Exemple

L’exemple ci-après montre comment appeler cette API.

Demande

POST https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/permanentDelete

Réponse

HTTP/1.1 204 No Content

Réponses d’erreur

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