Obtener un recurso DriveItem
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 $expand
pará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:
- Las solicitudes HEAD solo devolverán los encabezados de la solicitud GET correspondientes. Este es un procedimiento estándar para una respuesta HEAD.
- 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.