Supprimer une autorisation de partage d’un fichier ou d’un dossier
Supprimer l’accès à un DriveItem.
Seules les autorisations de partage qui ne sont pas héritées peuvent être supprimées.
La propriété inheritedFrom doit être null.
Autorisations
L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
| Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
|---|---|
| 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}/permissions/{perm-id}
DELETE /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /me/drive/items/{item-id}/permissions/{perm-id}
DELETE /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}
En-têtes de demande facultatifs
| Nom | Type | Description |
|---|---|---|
| if-match | string | Si cet en-tête de demande est inclus et que l’eTag (ou cTag) fourni ne correspond pas à la balise actuellement appliquée à l’élément, une réponse 412 Precondition Failed est renvoyée et l’élément n’est pas supprimé. |
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.
Exemple
Cet exemple supprime l’autorisation identifiée comme {perm-id} de l’élément {item-id} dans l’instance OneDrive de l’utilisateur actuel.
DELETE /me/drive/items/{item-id}/permissions/{perm-id}
Réponse
HTTP/1.1 204 No Content
Remarques
- Les lecteurs dont le driveType est
personal(OneDrive personnels) ne peuvent pas créer ou modifier d’autorisations sur la ressource DriveItem racine.