Berechtigung: revokeGrants

Namespace: microsoft.graph

Widerrufen Sie den Zugriff auf ein listItem oder driveItem , das über einen Freigabelink gewährt wurde, indem Sie die angegebenen driveRecipient-Einträge aus dem Link entfernen.

Empfänger, die den Link bereits eingelöst haben, sowie Empfänger, die nur eine Einladung erhalten haben, verlieren den Zugriff. Durch den Widerruf eines Zuschusses wird der Empfänger nur von diesem Freigabelink entfernt. Er entfernt keinen Zugriff, den der Empfänger über einen anderen Freigabelink, eine direkte Gewährung oder die Mitgliedschaft in einer Gruppe hat, die Zugriff hat.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

HTTP-Anforderung

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

Anforderungsheader

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Aktion verwendet werden können.

Antwort

Bei erfolgreicher Aktion werden ein 200 OK Antwortcode und eine Berechtigung im Antworttext zurückgegeben, die den aktualisierten Status des Freigabelinks darstellen.

Die grantedToIdentitiesV2-Eigenschaft der zurückgegebenen Berechtigung listet die Empfänger des Links auf, nachdem die angegebenen Berechtigungen widerrufen wurden.

Diese Aktion gilt nur für das Freigeben von Links. Er kann nicht verwendet werden, um einen direkten Zuschuss für einen Gegenstand zu widerrufen. verwenden Sie stattdessen die Entf-Berechtigung . Die Angabe des Bezeichners einer Berechtigung, bei der es sich nicht um einen Freigabelink handelt, gibt einen 400 Bad Request Antwortcode zurück.

Der Freigabelink muss auf bestimmte Benutzer beschränkt sein. Links, deren Bereich einzelne Stipendiaten nachverfolgt anonymous oder organization nicht nachverfolgt. Da für diese Links keine einzelnen Genehmigungen widerrufen werden können, gibt die Anforderung einen 400 Bad Request Antwortcode zurück.

Weitere Informationen zur Rückgabe von Fehlern finden Sie unter Microsoft Graph-Fehlerantworten und Ressourcentypen.

Beispiele

Anforderung

Im folgenden Beispiel wird gezeigt, wie Sie den Zugriff eines einzelnen Benutzers auf einen Freigabelink widerrufen.

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"
    }
  ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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/..."
  }
}