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 la CPU, la E/S del disco y la 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 se requiere para leer datos de objetos con la consola de Cloud de Confiance )
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 Storage (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 consola de Cloud de Confiance .
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Para obtener instrucciones para otorgar roles a los buckets, consulta Configura y administra políticas de IAM en buckets.
Cómo leer objetos de manera 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
Cómo leer objetos de forma interactiva
En esta sección, se describe cómo leer objetos de forma interactiva en la ventana del navegador de la consolaCloud de Confiance o en la terminal de línea de comandos stdout.
Console
- En la consola de Cloud de Confiance , 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 Objects, 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 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 tu terminal stdout, usa el comando gcloud storage cat:
gcloud storage cat gs://BUCKET_NAME/OBJECT_NAME
Reemplaza lo siguiente:
BUCKET_NAME: Es el nombre del bucket que contiene el objeto que deseas leer. Por ejemplo,my-bucketOBJECT_NAME: Es 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 tu terminal stdout, sigue estas instrucciones.
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
AuthorizationUsa
cURLpara llamar a la API de JSON con una solicitud deobjects.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: Es el nombre del bucket que contiene el objeto que deseas leer. Por ejemplo,my-bucket.OBJECT_NAME: Es el nombre codificado como URL del objeto que deseas leer. 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
AuthorizationUsa
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: Es el nombre del bucket que contiene el objeto que deseas leer. Por ejemplo,my-bucket.OBJECT_NAME: Es el nombre codificado como URL del objeto que deseas leer. Por ejemplo,pets/dog.png, codificado en URL comopets%2Fdog.png.