permiso: revokeGrants

Espacio de nombres: microsoft.graph

Revocar el acceso a un listItem o driveItem concedido a través de un vínculo para compartir quitando las entradas de driveRecipient especificadas del vínculo.

Tanto los destinatarios que ya canjearon el vínculo como los destinatarios que solo recibieron una invitación pierden el acceso. La revocación de una subvención elimina al destinatario solo de este enlace para compartir; No quita el acceso que tenga el destinatario a través de un vínculo para compartir diferente, una concesión directa o la pertenencia a un grupo que tenga acceso.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Solicitud 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

Encabezados de solicitud

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.

La siguiente tabla muestra los parámetros que se pueden usar con esta acción.

Respuesta

Si se realiza correctamente, esta acción devuelve un 200 OK código de respuesta y un permiso en el cuerpo de la respuesta que representa el estado actualizado del vínculo para compartir.

La propiedad grantedToIdentitiesV2 del permiso devuelto enumera los destinatarios en el vínculo después de revocar las concesiones especificadas.

Esta acción solo se aplica a los vínculos para compartir. No se puede usar para revocar una subvención directa sobre un elemento; use el permiso Eliminar en su lugar. Si se proporciona el identificador de un permiso que no es un vínculo para compartir, se devuelve un 400 Bad Request código de respuesta.

El vínculo para compartir debe tener un ámbito específico para cada usuario. Enlaces cuyo alcance es anonymous o organization no seguimiento de beneficiarios individuales. Dado que estos vínculos no tienen concesiones individuales para revocar, la solicitud devuelve un 400 Bad Request código de respuesta.

Para obtener más información sobre cómo se devuelven los errores, consulte Respuestas de error de Microsoft Graph y tipos de recursos.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra cómo revocar el acceso de un solo usuario en un vínculo para compartir.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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