Compartir a través de

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

Espacio de nombres: microsoft.graph

Quitar el acceso a un driveItem.

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 archivoStorageContainer 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 nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.
if-match Cadena. Si se incluye este encabezado de solicitud y la eTag (o cTag) proporcionada no coincide con la etiqueta actual del elemento, se devuelve una 412 Precondition Failed respuesta y no se elimina el elemento.

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/v1.0/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 driveItem raíz.
  • Last updated on