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

  • Article
  • 2 minutes de lecture

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 nécessaire 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 moins de privilèges à celle qui en offre le plus)
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.