En esta página, se muestra cómo descargar objetos de tus buckets en Cloud Storage en almacenamiento continuo. También puedes descargar objetos en la memoria.
Roles obligatorios
Para obtener los permisos necesarios para descargar objetos, pídele a tu administrador que te otorgue el rol de visualizador de objetos de almacenamiento (roles/storage.objectViewer
) en el bucket. Si planeas usar la consola de Google Cloud, pídele a tu administrador que te otorgue el rol de administrador de almacenamiento (roles/storage.admin
) en el bucket.
Estos roles contienen los permisos necesarios para enumerar objetos. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
storage.buckets.list
- Este permiso solo es necesario para usar la consola de Google Cloud para hacer la tarea en esta página.
storage.objects.get
storage.objects.list
- Este permiso solo es necesario para usar la consola de Google Cloud para hacer la tarea en esta página.
También puedes obtener estos permisos con otros roles predefinidos o roles personalizados.
Para obtener instrucciones para otorgar roles a los buckets, consulta Usa IAM con buckets.
Descargarás un objeto de un bucket.
Completa las siguientes instrucciones para descargar un objeto de un bucket:
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket que contiene el objeto que quieras descargar.
Se abrirá la página Detalles del bucket y se seleccionará la pestaña Objetos.
Navega hasta el objeto, que puede estar en una carpeta.
Haz clic en el ícono Descargar asociado al objeto.
La configuración de tu navegador controla la ubicación de descarga del objeto.
Para obtener información acerca de cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la consola de Google Cloud, consulta Solución de problemas.
Línea de comandos
Usa el comando gcloud storage cp
:
gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
Aquí:
BUCKET_NAME
es el nombre del depósito que contiene el objeto que se descargará. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre del objeto que se descargará. Por ejemplo,pets/dog.png
SAVE_TO_LOCATION
es la ruta local en la que guardas tu objeto. Por ejemplo,Desktop/Images
Si es correcto, la respuesta se parece al siguiente ejemplo:
Completed files 1/1 | 164.3kiB/164.3kiB
Si se interrumpe la descarga antes de que se complete, ejecuta el mismo comando cp
para reanudar la descarga desde donde se detuvo.
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
En la siguiente muestra, se descarga un objeto individual:
En el siguiente ejemplo, se descargan varios objetos por medio de varios procesos:
En el siguiente ejemplo, se descargan todos los objetos con un prefijo común por medio de varios procesos:
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
En la siguiente muestra, se descarga un objeto individual:
En el siguiente ejemplo, se descargan varios objetos por medio de varios procesos:
En el siguiente ejemplo, se descargan todos los objetos con un prefijo común por medio de varios procesos:
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
En la siguiente muestra, se descarga un objeto individual:
En el siguiente ejemplo, se descargan varios objetos por medio de varios procesos:
En la siguiente muestra, se descargan todos los objetos en un bucket por medio de varios procesos:
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Usa
cURL
para llamar a la API de JSON con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Aquí:
SAVE_TO_LOCATION
es la ruta a la ubicación en la que deseas guardar el objeto. Por ejemplo,Desktop/dog.png
.BUCKET_NAME
es el nombre del bucket que contiene el objeto que se descargará. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado en URL del objeto que deseas descargar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
API de XML
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Usa
cURL
para llamar a la API de XML con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Aquí:
SAVE_TO_LOCATION
es la ruta a la ubicación en la que deseas guardar el objeto. Por ejemplo,Desktop/dog.png
.BUCKET_NAME
es el nombre del bucket que contiene el objeto que se descargará. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado en URL del objeto que deseas descargar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
Para descargar de manera más eficiente todos los objetos de un bucket o subdirectorio, usa el comando gcloud storage cp
o una biblioteca cliente.
Descarga una parte de un objeto
Si se interrumpe la descarga, puedes reanudar desde donde quedaste mediante la solicitud de solo la parte del objeto que queda. Completa las siguientes instrucciones para descargar una parte de un objeto.
Console
La consola de Google Cloud no admite la descarga de partes de un objeto. En su lugar, usa la CLI de gcloud.
Línea de comandos
Google Cloud CLI intenta reanudar las descargas interrumpidas de forma automática, excepto cuando se realizan descargas de transmisión. Si se interrumpe la descarga, se verá un archivo temporal descargado de forma parcial en la jerarquía de destino. Ejecuta el mismo comando cp
para reanudar la descarga desde el punto en que se detuvo.
Cuando se completa la descarga, se borra el archivo temporal y se lo reemplaza por el contenido que se descargó. Los archivos temporales se almacenan en una ubicación configurable que, de forma predeterminada, se encuentra en el directorio principal del usuario en .config/gcloud/surface_data/storage/tracker_files
. Puedes cambiar o ver la ubicación en la que se almacenan los archivos temporales si ejecutas gcloud config get storage/tracker_files_directory
.
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
API de REST
API de JSON
Usa el encabezado Range
en la solicitud para descargar una parte de un objeto.
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Usa
cURL
para llamar a la API de JSON con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Aquí:
FIRST_BYTE
es el primer byte en el rango de bytes que deseas descargar. Por ejemplo,1000
LAST_BYTE
es el último byte en el rango de bytes que deseas descargar. Por ejemplo,1999
SAVE_TO_LOCATION
es la ruta a la ubicación en la que deseas guardar el objeto. Por ejemplo,Desktop/dog.png
.BUCKET_NAME
es el nombre del bucket que contiene el objeto que se descargará. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado en URL del objeto que deseas descargar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
API de XML
Usa el encabezado Range
en la solicitud para descargar una parte de un objeto.
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Usa
cURL
para llamar a la API de XML con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Aquí:
FIRST_BYTE
es el primer byte en el rango de bytes que deseas descargar. Por ejemplo,1000
LAST_BYTE
es el último byte en el rango de bytes que deseas descargar. Por ejemplo,1999
SAVE_TO_LOCATION
es la ruta a la ubicación en la que deseas guardar el objeto. Por ejemplo,$HOME/Desktop/dog.png
.BUCKET_NAME
es el nombre del bucket que contiene el objeto que se descargará. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado en URL del objeto que deseas descargar. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
¿Qué sigue?
- Lee la descripción general conceptual para subir y descargar contenido, incluidas las estrategias de descarga avanzadas.
- Transfiere datos desde proveedores de servicios en la nube o desde otras fuentes en línea, como listas de URL.
- Transfiere objetos a tu instancia de Compute Engine.
- Obtén información para facturar a los solicitantes los cargos de acceso a Cloud Storage.
- Obtén información para saber cómo Cloud Storage puede entregar archivos en formato gzip sin comprimir.
Pruébalo tú mismo
Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Storage en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
Probar Cloud Storage gratis