Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Descargue el contenido de la secuencia principal (archivo) de un objeto driveItem. Solo se pueden descargar objetos driveItem con la propiedad file .
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.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 |
Nota:
SharePoint Embedded requiere el FileStorageContainer.Selected permiso para acceder al contenido del contenedor. Este permiso es diferente de los mencionados anteriormente. Además de los permisos de Microsoft Graph, la aplicación debe tener los permisos de tipo de contenedor necesarios para llamar a esta API. Para obtener más información, vea Autenticación y autorización de SharePoint Embedded.
Solicitud HTTP
GET /drives/{drive-id}/items/{item-id}/contentStream
GET /groups/{group-id}/drive/items/{item-id}/contentStream
GET /me/drive/root:/{item-path}:/contentStream
GET /me/drive/items/{item-id}/contentStream
GET /shares/{shareIdOrEncodedSharingUrl}/driveItem/contentStream
GET /sites/{siteId}/drive/items/{item-id}/contentStream
GET /users/{userId}/drive/items/{item-id}/contentStream
Parámetros de consulta opcionales
Este método no admite los parámetros de consulta de OData para ayudar a personalizar la respuesta.
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Preferir: forceInfectedDownload | Si se proporciona, la solicitud puede descargar un archivo infectado. En el caso de las solicitudes delegadas, si la configuración del inquilino DisallowInfectedFileDownload está habilitada, solo los administradores de inquilinos o los administradores globales pueden descargar el archivo. Las solicitudes de solo aplicación descargan un archivo infectado independientemente de la configuración del inquilino. Opcional. |
| Rango | bytes={range-start}-{range-end}/{size}. Opcional. Use para descargar un intervalo parcial de bytes del archivo. Se especifica en RFC 2616. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de 200 OK respuesta HTTP.
Ejemplos
Ejemplo 1: Descarga del contenido del archivo
En el ejemplo siguiente se muestra cómo descargar un archivo.
Solicitud
GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-Type: text/plain
<File Content>
Ejemplo 2: Descarga de un intervalo parcial de bytes
Para descargar un intervalo parcial de bytes del archivo, la aplicación puede usar el Range encabezado , tal como se especifica en RFC 2616.
Solicitud
GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream
Range: bytes=0-1023
Respuesta
La llamada devuelve una 206 Partial Content respuesta HTTP con el intervalo solicitado de bytes del archivo. Si no se puede generar el intervalo, se omite el Range encabezado y se devuelve una 200 OK respuesta HTTP con el contenido completo del archivo.
HTTP/1.1 206 Partial Content
Content-Type: text/plain
<First 1024 bytes of the file>