autorisation : revokeGrants

Espace de noms: microsoft.graph

Révoquez l’accès à un listItem ou à un driveItem accordé via un lien de partage en supprimant les entrées driveRecipient spécifiées du lien.

Les destinataires qui ont déjà utilisé le lien et les destinataires qui ont uniquement reçu une invitation perdent l’accès. La révocation d’une subvention supprime le bénéficiaire de ce lien de partage uniquement ; Elle ne supprime aucun accès dont dispose le destinataire par le biais d’un lien de partage différent, d’une attribution directe ou de l’appartenance à un groupe qui y a accès.

Remarque

Cette action n’est prise en charge que sur le partage de liens limités à des utilisateurs spécifiques.

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) Non prise en charge. Non prise en charge.
Application Files.ReadWrite.All Sites.ReadWrite.All

Requête HTTP

POST /drives/{drive-id}/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /me/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /sites/{site-id}/lists/{list-id}/items/{listItem-id}/driveItem/permissions/{perm-id}/revokeGrants
POST /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants

En-têtes de demande

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

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant indique les paramètres utilisables avec cette action.

Paramètre Type Description
Bénéficiaires collecte driveRecipient Obligatoire. Une collection de destinataires dont l’accès au lien de partage est révoqué.

Réponse

En cas de succès, cette action renvoie un 200 OK code de réponse et une autorisation dans le corps de la réponse qui représente l’état mis à jour du lien de partage.

La propriété grantToIdentitiesV2 de l’autorisation renvoyée répertorie les destinataires du lien après la révocation des autorisations spécifiées.

Cette action s’applique uniquement au partage de liens. Il ne peut pas être utilisé pour révoquer une subvention directe sur un article ; utilisez plutôt l’autorisation Supprimer . La fourniture de l’identificateur d’une autorisation qui n’est pas un lien de partage renvoie un 400 Bad Request code de réponse.

Le lien de partage doit être limité à des utilisateurs spécifiques. Liens dont la portée est anonymous ou organization ne suit pas les bénéficiaires individuels. Étant donné que ces liens n’ont aucune subvention individuelle à révoquer, la demande retourne un 400 Bad Request code de réponse.

Pour plus d’informations sur la façon dont les erreurs sont retournées, consultez Réponses aux erreurs et types de ressources de Microsoft Graph.

Exemples

Demande

L’exemple suivant montre comment révoquer l’accès d’un seul utilisateur sur un lien de partage.

POST https://graph.microsoft.com/v1.0/me/drive/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/permissions/2687a7e0-1b4d-4656-ae32-a4ea393321e1/revokeGrants
Content-Type: application/json

{
  "grantees": [
    {
      "email": "ryan@contoso.com"
    }
  ]
}

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

{
  "id": "2687a7e0-1b4d-4656-ae32-a4ea393321e1",
  "roles": ["write"],
  "grantedToIdentitiesV2": [
    {
      "user": {
        "id": "e6842c7e-33a1-4207-8b5a-2710922ac2b2",
        "displayName": "Megan Bowen"
      },
      "siteUser": {
        "id": "12",
        "displayName": "Megan Bowen",
        "loginName": "Megan Bowen"
      }
    }
  ],
  "link": {
    "type": "edit",
    "scope": "users",
    "webUrl": "https://contoso-my.sharepoint.com/personal/ellen_contoso_com/..."
  }
}
  • Dernière mise à jour :