Partager via

Obtenir une autorisation de partage pour un fichier ou un dossier

  • Article

Découvrez comment renvoyer l’autorisation de partage effective pour une ressource d’autorisation particulière.

Les autorisations effectives d’un élément peuvent provenir de deux sources : les autorisations définies directement sur l’élément lui-même ou les autorisations héritées des ancêtres de l’élément.

Les appelants peuvent distinguer si l’autorisation est héritée ou non en vérifiant la propriété inheritedFrom. Cette propriété est une ressource itemReference faisant référence à l’ancêtre dont l’autorisation est héritée.

Les niveaux d’autorisation SharePoint définis sur un élément sont renvoyés avec le préfixe « SP ». Par exemple, SP.Affichage seul, SP.Accès limité, SP.Afficher les données Web Analytics. Voir la liste complète des rôles SharePoint.

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.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Application Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Requête HTTP

GET /drives/{drive-id}/items/{item-id}/permissions/{perm-id}
GET /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
GET /me/drive/items/{item-id}/permissions/{perm-id}
GET /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
GET /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}

Paramètres facultatifs de la requête

Cette méthode prend en charge le paramètre de requête $select pour formuler la réponse.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une ressource Permission dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande d’accès à une autorisation sur un dossier.

GET /me/drive/items/{item-id}/permissions/{perm-id}

Réponse

En cas de réussite, cette méthode renvoie une ressource Permission pour l’ID indiqué.

HTTP/1.1 200 OK
Content-type: application/json

{
  "grantedTo": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "efee1b77-fb3b-4f65-99d6-274c11914d12"
    }
  },
  "id": "1",
  "roles": [ "write" ]
}

Remarques

La ressource Permission utilise des facettes pour fournir des informations sur le type d’autorisation représenté par la ressource.

Les autorisations avec une facette link représentent les liens de partage créés sur l’élément. Les liens de partage contiennent un jeton unique qui permet à toute personne disposant du lien d’accéder à l’élément.

Les autorisations avec une facette invitation représentent les autorisations ajoutées en invitant des utilisateurs ou des groupes spécifiques à accéder au fichier.

Réponses d’erreur

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