Share via

Obtener permiso de uso compartido de un archivo o una carpeta

  • Artículo

Devuelva el permiso efectivo de uso compartido para un recurso de permiso en concreto.

Los permisos efectivos de un elemento pueden provenir de dos orígenes: permisos que se establecen directamente en el propio elemento o permisos que se heredan de los antecesores del elemento.

Los autores de llamadas pueden distinguir si el permiso se hereda o no comprobando la propiedad inheritedFrom. Esta propiedad es un recurso ItemReference que hace referencia al antecesor del que se hereda el permiso.

Los niveles de permiso de SharePoint establecidos en un elemento se devuelven con un prefijo "SP". Por ejemplo, SP.View Only, SP.Limited Access, SP.View Web Analytics Data. Vea Lista completa de roles de SharePoint.

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.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Aplicación Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitud HTTP

GET /drives/{drive-id}/items/{item-id}/permissions/{perm-id}
GET /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
GET /me/drive/items/{item-id}/permissions/{perm-id}
GET /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
GET /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}

Parámetros de consulta opcionales

Este método admite el parámetro de consulta $select para dar forma a la respuesta.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y el recurso Permission en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud para obtener acceso a un permiso en una carpeta.

GET /me/drive/items/{item-id}/permissions/{perm-id}

Respuesta

Si se ejecuta correctamente, este método devuelve un recurso Permission para el identificador especificado.

HTTP/1.1 200 OK
Content-type: application/json

{
  "grantedTo": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "efee1b77-fb3b-4f65-99d6-274c11914d12"
    }
  },
  "id": "1",
  "roles": [ "write" ]
}

Comentarios

El recurso Permission usa facetas para proporcionar información sobre el tipo de permiso que representa el recurso.

Los permisos con una faceta link representan vínculos para compartir creados en el elemento. Los vínculos para compartir contienen un token único que proporciona acceso al elemento a cualquier usuario con el vínculo.

Los permisos con una faceta invitation representan los permisos agregados al invitar a usuarios o grupos específicos para que tengan acceso al archivo.

Respuestas de error

Lea el tema Respuestas de error para obtener más información sobre la manera en que se devuelven los errores.