Share via

Supprimer une autorisation de partage d’un fichier ou d’un dossier

  • Article

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.