En esta página, se muestra cómo descargar objetos de tus buckets en Cloud Storage. Para obtener una descripción general conceptual, consulta Cargas y descargas.
Requisitos previos
Los requisitos previos pueden variar según la herramienta que se use:
Consola
Para completar esta guía con Google Cloud Console, debes tener los permisos de IAM adecuados. Si el bucket desde el que deseas descargar existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con los permisos necesarios.
A fin de obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para Google Cloud Console.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Línea de comandos
Para completar esta guía con una utilidad de línea de comandos, debes tener los permisos de IAM adecuados. Si el bucket desde el que deseas descargar existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para los comandos de gsutil.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Muestras de código
Para completar esta guía con las bibliotecas cliente de Cloud Storage, debes tener los permisos de IAM adecuados. Si el bucket desde el que deseas descargar existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con los permisos necesarios. A menos que se indique lo contrario, las solicitudes de la biblioteca cliente se realizan mediante la API de JSON.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
API de REST
API de JSON
Para completar esta guía con la API de JSON, debes tener los permisos de IAM adecuados. Si el bucket desde el que deseas descargar existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Descarga un objeto de un bucket
Completa las siguientes instrucciones para descargar un objeto de un bucket:
Console
- En Google Cloud Console, ve a la página Navegador de Cloud Storage.
En la lista de bucket s, haz clic en el nombre del bucket que contiene el objeto que deseas 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 aprender a obtener información detallada sobre errores en las operaciones fallidas en el navegador de Cloud Storage, consulta Solución de problemas.
Línea de comandos
gcloud
Usa el comando gcloud alpha storage cp
:
gcloud alpha storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
En el ejemplo anterior, se ilustra lo siguiente:
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.
gsutil
Usa el comando gsutil cp
:
gsutil cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
En el ejemplo anterior, se ilustra lo siguiente:
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:
Operation completed over 1 objects/58.8 KiB.
Si se interrumpe la descarga antes de que se complete, ejecuta el mismo comando cp
para reanudar la descarga desde donde se detuvo.
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
En el siguiente ejemplo, se descarga un objeto a un archivo:
En el siguiente ejemplo, se descarga un objeto a la memoria:
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.
En el siguiente ejemplo, se descarga un objeto a un archivo:
En el siguiente ejemplo, se descarga un objeto a la memoria:
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.
En el siguiente ejemplo, se descarga un objeto a un archivo:
En el siguiente ejemplo, se descarga un objeto a la memoria:
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.
En el siguiente ejemplo, se descarga un objeto a un archivo:
En el siguiente ejemplo, se descarga un objeto a la memoria:
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.
En el siguiente ejemplo, se descarga un objeto a un archivo:
En el siguiente ejemplo, se descarga un objeto a la memoria:
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.
En el siguiente ejemplo, se descarga un objeto a un archivo:
En el siguiente ejemplo, se descarga un objeto a la memoria:
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.
En el siguiente ejemplo, se descarga un objeto a un archivo:
En el siguiente ejemplo, se descarga un objeto a la memoria:
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.
En el siguiente ejemplo, se descarga un objeto a un archivo:
En el siguiente ejemplo, se descarga un objeto a la memoria:
API de REST
API de JSON
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de JSON con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
En el ejemplo anterior, se ilustra lo siguiente:
OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.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
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de XML con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Donde:
OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.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 con facilidad todos los objetos de un bucket o subdirectorio, usa el comando gsutil cp
o gcloud alpha storage cp
.
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 no admite la descarga de partes de un objeto. En su lugar, usa gsutil.
Línea de comandos
gcloud
gcloud intenta reanudar las descargas interrumpidas de forma automática, excepto cuando se realizan transferencias 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
.
gsutil
gsutil intenta reanudar las descargas interrumpidas de forma automática, excepto cuando se realizan transferencias de transmisión. Si se interrumpe la descarga, se verá un archivo temporal descargado de forma parcial en el directorio 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ó. Las transferencias reanudables almacenan información de estado en los archivos en ~/.gsutil
, nombrados por el objeto o archivo de destino.
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.
API de REST
API de JSON
Usa el encabezado Range
en la solicitud para descargar una parte de un objeto.
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de JSON con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_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"
En el ejemplo anterior, se ilustra lo siguiente:
OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.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.
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de XML con una solicitud de objetoGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Donde:
OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.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.
- Obtén más información sobre cómo realizar descargas transmitidas.
- Transfiere datos desde proveedores de servicios en la nube o desde otras fuentes en línea (por ejemplo, mediante listas de URL).
- Transfiere objetos a tu instancia de Compute Engine.
- Obtén información sobre cómo facturar a los solicitantes los cargos de acceso a Cloud Storage.
- Obtén información sobre 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