Compartir a través de

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

  • Artículo

Quita el acceso a un DriveItem.

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

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
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 el encabezado de la solicitud y la eTag (o cTag) proporcionada no coincide con la etiqueta actual del archivo, se devuelve una respuesta 412 Precondition Failed y el elemento no se borrará.

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 /me/drive/items/{item-id}/permissions/{perm-id}

Respuesta

HTTP/1.1 204 No Content

Comentarios

  • Los Drives con un driveType de personal (OneDrive Personal) no pueden crear ni modificar permisos en la DriveItem raíz.