Subidas y descargas

En esta página se explican conceptos relacionados con la subida y descarga de objetos. Puedes subir y almacenar datos de cualquier tipo MIME de hasta 5 TiB.

Subidas

Puedes enviar solicitudes de subida a Cloud Storage de las siguientes formas:

  • Subida de una sola solicitud. Método de subida en el que un objeto se sube como una sola solicitud. Usa esta opción si el archivo es lo suficientemente pequeño para subirlo por completo si falla la conexión. Consulta las guías para realizar cargas con una sola solicitud en Subir objeto desde un archivo o Subir objeto desde la memoria.

    • Subida multiparte de la API JSON. Método de subida que te permite subir tanto los datos de un objeto como sus metadatos en una sola solicitud. Sin embargo, la API XML permite definir metadatos de objetos en todos los tipos de subidas.

  • Subida reanudable Un método de subida que proporciona una transferencia más fiable, lo que es especialmente importante en el caso de los archivos de gran tamaño. Las subidas reanudables son una buena opción para la mayoría de las aplicaciones, ya que también funcionan con archivos pequeños, aunque con el coste de una solicitud HTTP adicional por cada subida. También puedes usar subidas reanudables para realizar transferencias de streaming, lo que te permite subir un objeto de tamaño desconocido.

  • Subida multiparte de la API XML Un método de subida compatible con las subidas multiparte de Amazon S3. Los archivos se suben por partes y se ensamblan en un solo objeto con la solicitud final. Las subidas multiparte de la API XML te permiten subir las partes en paralelo, lo que puede reducir el tiempo necesario para completar la subida.

Con estos tipos de subida básicos, se pueden llevar a cabo estrategias de subida más avanzadas:

  • Subida compuesta en paralelo. Estrategia de subida en la que se divide un archivo en fragmentos y se suben los fragmentos en paralelo. A diferencia de las subidas multiparte de la API XML, las subidas compuestas paralelas usan la operación de composición y el objeto final se almacena como un objeto compuesto.

  • Subida de streaming. Un método de subida que te permite subir datos sin que estos se guarden primero en un archivo. Esto resulta útil cuando no sabes el tamaño total de la subida al principio.

  • Subida con codificación de transferencia fragmentada. Una subida con una sola solicitud que incluye el encabezado Transfer-Encoding: chunked, lo que permite que la subida se envíe en varios fragmentos de datos secuenciales.

Consideraciones sobre el tamaño de subida

Cuando elijas si quieres usar una subida de una sola solicitud en lugar de una subida reanudable o una subida multiparte de la API XML, ten en cuenta el tiempo que estás dispuesto a perder si se produce un fallo en la red y tienes que reiniciar la subida desde el principio. Para que las conexiones sean más rápidas, el tamaño de corte suele ser mayor.

Por ejemplo, supongamos que estás dispuesto a tolerar 30 segundos de tiempo perdido:

  • Si subes contenido desde un sistema local con una velocidad de subida media de 8 Mbps, puedes usar la subida con una sola solicitud para archivos de hasta 30 MB.

  • Si subes contenido desde un servicio de la misma región que tiene una velocidad de subida media de 500 Mbps, el tamaño máximo de los archivos será de casi 2 GB.

Descargas

Todas las descargas de Cloud Storage tienen el mismo comportamiento básico: una solicitud HTTP o HTTPS GET que puede incluir un encabezado Range opcional, que define una parte específica del objeto que se va a descargar.

Con este comportamiento de descarga básico, puedes reanudar las descargas interrumpidas y utilizar estrategias de descarga más avanzadas, como las descargas de objetos segmentados y las descargas por streaming.

Asistencia por herramienta

Consola

Puedes realizar los siguientes tipos de subidas y descargas con la consolaGoogle Cloud :

Línea de comandos

Puedes realizar los siguientes tipos de subidas y descargas cuando usas la CLI de Google Cloud:

Bibliotecas de cliente

C++

Puedes realizar los siguientes tipos de subidas y descargas cuando usas la biblioteca de cliente de C++:

C#

Puedes realizar los siguientes tipos de subidas y descargas cuando usas la biblioteca de cliente de C#:

Go

Puedes realizar los siguientes tipos de subidas y descargas cuando usas la biblioteca de cliente de Go:

Java

Puedes realizar los siguientes tipos de subidas y descargas cuando usas la biblioteca de cliente de Java:

Node.js

Puede realizar los siguientes tipos de subidas y descargas cuando utilice la biblioteca de cliente de Node.js:

PHP

Puedes realizar los siguientes tipos de subidas y descargas cuando usas la biblioteca de cliente de PHP:

Python

Puedes realizar los siguientes tipos de subidas y descargas cuando usas la biblioteca de cliente de Python:

Ruby

Puedes realizar los siguientes tipos de subidas y descargas cuando usas la biblioteca de cliente de Ruby:

Terraform

Puedes realizar subidas de una sola solicitud cuando usas Terraform. Las subidas reanudables se producen automáticamente cuando el archivo que se está subiendo tiene un tamaño superior a 16 MiB.

APIs REST

API JSON

Cuando usas la API JSON, puedes realizar los siguientes tipos de subidas y descargas:

API XML

Puede realizar los siguientes tipos de subidas y descargas con la API XML:

Si usas APIs REST para subir y descargar contenido, consulta Puntos de conexión de solicitudes para obtener información completa sobre los puntos de conexión de solicitudes que puedes usar.

Siguientes pasos