Eliminar un permiso de uso compartido de un archivo o una carpeta

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Quitar el acceso a un elemento de unidad.

Solo se pueden eliminar los permisos de uso compartido que no se heredan. La propiedad inheritedFrom debe ser null.

Importante

En SharePoint Embedded, los permisos agregados a un fileStorageContainer no se pueden quitar de sus objetos driveItem , lo que significa que los usuarios y grupos con permisos de contenedor tienen acceso a todos los elementos de ese contenedor.

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

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

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.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Files.ReadWrite Files.ReadWrite.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) Files.ReadWrite Files.ReadWrite.All
Aplicación Files.ReadWrite.All Sites.ReadWrite.All

Solicitud 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}

Encabezados de solicitud opcionales

Nombre Tipo Descripción
if-match string Si se incluye este encabezado de solicitud y el eTag (o cTag) proporcionado no coincide con la etiqueta actual del elemento, se devuelve una 412 Precondition Failed respuesta y el elemento no se elimina.

Respuesta

Si se ejecuta correctamente, este método devuelve el código de respuesta 204 No Content.

Ejemplo

En este ejemplo, se quita el permiso identificado como {perm-id} del elemento {item-id} del OneDrive del usuario actual.

DELETE https://graph.microsoft.com/beta/me/drive/items/{item-id}/permissions/{perm-id}

Respuesta

HTTP/1.1 204 No Content

Comentarios

  • Las unidades con un driveType de personal (OneDrive Personal) no pueden crear ni modificar permisos en el elemento de unidad raíz.
  • Last updated on