Compartir a través de


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

Espacio de nombres: microsoft.graph

Quita el acceso a un DriveItem.

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

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 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 https://graph.microsoft.com/v1.0/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.