En esta página, se muestra cómo leer datos de objetos de tus buckets de Cloud Storage directamente en la memoria de la aplicación o de forma interactiva en tu navegador web o terminal de línea de comandos. Se recomienda leer objetos en la memoria o de forma interactiva cuando deseas transmitir, inspeccionar o procesar datos de una manera que evite la sobrecarga de CPU, E/S de disco y latencia asociada con la escritura de archivos en un sistema de archivos local persistente.
Para obtener instrucciones sobre cómo descargar objetos en el almacenamiento persistente o local, consulta Descarga objetos. Para obtener una descripción general conceptual de las lecturas y descargas de objetos, consulta Lecturas y descargas de objetos.
Roles obligatorios
Para obtener los permisos que necesitas para leer datos de objetos, pídele a tu administrador que te otorgue los siguientes roles de IAM:
- Visualizador de objetos de almacenamiento (
roles/storage.objectViewer) en el bucket - Administrador de almacenamiento (
roles/storage.admin) en el proyecto (solo es necesario para leer datos de objetos con la Cloud de Confiance console)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
El rol de visualizador de objetos de almacenamiento (roles/storage.objectViewer) contiene el permiso storage.objects.get, que es necesario para leer objetos. El rol de administrador de almacenamiento (roles/storage.admin) contiene los permisos storage.buckets.list y storage.buckets.get, además del permiso storage.objects.get. Estos permisos son necesarios para enumerar los buckets de un proyecto y ver información sobre ellos. El rol de administrador de almacenamiento
(roles/storage.admin) que incluye estos permisos solo es necesario
cuando deseas leer objetos de forma interactiva con la Cloud de Confiance console.
También puedes obtener estos permisos con roles personalizados o otros roles predefinidos.
Para obtener instrucciones para otorgar roles a los buckets, consulta Configura y administra políticas de IAM en buckets.
Lee objetos de forma programática en la memoria
En esta sección, se describe cómo leer datos de objetos transmitiendo los bytes del objeto directamente a la memoria de la aplicación.
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.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
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.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
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.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
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.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
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.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
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.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
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.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
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.
Antes de ejecutar muestras de código, configura la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Rust
Lee objetos de forma interactiva
En esta sección, se describe cómo leer objetos de forma interactiva en la
Cloud de Confiance ventana del navegador de la consola o en la terminal de línea de comandosstdout.
Console
- En la Cloud de Confiance console, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket que posee el contenido que deseas ver.
En la pestaña Objetos, haz clic en el nombre del objeto que deseas leer.
En la página Detalles del objeto, haz clic en la URL pública o en la URL autenticada del objeto para leer sus datos.
Línea de comandos
Para transmitir la carga útil de bytes de un objeto directamente a la stdout de tu terminal,
usa el gcloud storage cat comando:
gcloud storage cat gs://BUCKET_NAME/OBJECT_NAME
Reemplaza lo siguiente:
BUCKET_NAME: el nombre del bucket que contiene el objeto que deseas leer. Por ejemplo,my-bucket.OBJECT_NAME: el nombre del objeto que deseas leer. Por ejemplo,dog.png.
API de REST
Para leer los bytes de un objeto y dirigir el flujo de salida a la stdout de tu terminal, usa las siguientes instrucciones.
API de JSON
Ten gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization.Usa
cURLpara llamar a la API de JSON con una solicitudobjects.getque incluya la opción-o -y el parámetro de consultaalt=media:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o - \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Reemplaza lo siguiente:
BUCKET_NAME: el nombre del bucket que contiene el objeto que deseas leer. Por ejemplo,my-bucket.OBJECT_NAME: el nombre codificado como URL del objeto que deseas leer. Por ejemplo,pets/dog.png, codificado como URL comopets%2Fdog.png.
API de XML
Ten gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization.Usa
cURLpara llamar a la API de XML con una solicitud de objetoGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
Reemplaza lo siguiente:
BUCKET_NAME: el nombre del bucket que contiene el objeto que deseas leer. Por ejemplo,my-bucket.OBJECT_NAME: el nombre codificado como URL del objeto que deseas leer. Por ejemplo,pets/dog.png, codificado como URL comopets%2Fdog.png.