Obtener un recurso DriveItem

  • Artículo

Recupera los metadatos de un DriveItem en un Drive a través del identificador o ruta de acceso del sistema.

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}
GET /drives/{drive-id}/root:/{item-path}
GET /groups/{group-id}/drive/items/{item-id}
GET /groups/{group-id}/drive/root:/{item-path}
GET /me/drive/items/{item-id}
GET /me/drive/root:/{item-path}
GET /sites/{siteId}/drive/items/{itemId}
GET /sites/{siteId}/drive/root:/{item-path}
GET /users/{userId}/drive/items/{itemId}
GET /users/{userId}/drive/root:/{item-path}

Parámetros de consulta opcionales

Este método admite los $expandparámetros de consulta y $select OData para personalizar la respuesta.

Puede usar el parámetro de cadena de consulta $expand para incluir los elementos secundarios de un elemento en la misma llamada al recuperar los metadatos de un elemento si el elemento tiene una relación children.

Encabezados de solicitud opcionales

Nombre Valor Descripción
if-none-match String Si se incluye el encabezado de la solicitud y la eTag (o cTag) proporcionada coincide con la etiqueta actual del archivo, se devuelve una respuesta HTTP 304 Not Modified.

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud a la carpeta raíz de OneDrive del usuario.

GET /me/drive/root

Respuesta

Aquí tiene un ejemplo de la respuesta.

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

{
  "createdBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "createdDateTime": "2016-03-21T20:01:37Z",
  "cTag": "\"c:{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},0\"",
  "eTag": "\"{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},1\"",
  "folder": { "childCount": 120 },
  "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
  "lastModifiedBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "lastModifiedDateTime": "2016-03-21T20:01:37Z",
  "name": "OneDrive",
  "root": { },
  "size": 157286400,
  "webUrl": "https://contoso-my.sharepoint.com/personal/rgregg_contoso_com/Documents"
}

Solicitudes HEAD

En la mayoría de los casos, una solicitud HEAD se comportará de la misma manera que una solicitud GET.

Existen un par de diferencias:

  1. Las solicitudes HEAD solo devolverán los encabezados de la solicitud GET correspondientes. Este es un procedimiento estándar para una respuesta HEAD.
  2. Las solicitudes HEAD no aprovisionarán automáticamente una carpeta especial. En su lugar, si una carpeta especial no está presente, se devolverá un error 404.

En este ejemplo, puede ver que solicitando la raíz de OneDrive se responderá simplemente con 200 OK.

Solicitud HTTP

HEAD /drive/root
Accept: application/json

Respuesta

HTTP/1.1 200 OK

Comentarios

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