Descubre el almacenamiento de objetos con Google Cloud CLI

Descubre el almacenamiento de objetos con Google Cloud CLI

En esta página, se muestra cómo realizar tareas básicas en Cloud Storage con Google Cloud CLI.

Los costos se generan en Cloud Storage según los recursos que usas. Por lo general, en esta guía de inicio rápido, se usa menos de $0.01 en recursos de Cloud Storage.

Antes de comenzar

Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
Instala Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
Para inicializar gcloud CLI, ejecuta el siguiente comando:
gcloud init
Crea o selecciona un Google Cloud proyecto.
Roles necesarios para seleccionar o crear un proyecto
• Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.
Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.
• Crea un Google Cloud proyecto:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

• Selecciona el proyecto Google Cloud que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.
Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .
Otorga roles a tu cuenta de usuario. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM: roles/storage.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Reemplaza lo siguiente:
• PROJECT_ID: ID del proyecto
• USER_IDENTIFIER: Es el identificador de tu cuenta de usuario de . Por ejemplo, [e-mail].
• ROLE: Es el rol de IAM que otorgas a tu cuenta de usuario.

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un Google Cloud proyecto:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

• Selecciona el proyecto Google Cloud que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

Otorga roles a tu cuenta de usuario. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM: roles/storage.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Reemplaza lo siguiente:

• PROJECT_ID: ID del proyecto
• USER_IDENTIFIER: Es el identificador de tu cuenta de usuario de . Por ejemplo, [e-mail].
• ROLE: Es el rol de IAM que otorgas a tu cuenta de usuario.

Nota: Si usas Cloud Shell o una instancia de Compute Engine, el SDK de Google Cloud está preinstalado y autenticado. Si tu instancia de Compute Engine está configurada sin un permiso de cuenta de servicio para Cloud Storage, ejecuta gcloud init y sigue las instrucciones.

Cree un bucket

Los buckets son los contenedores básicos que conservan tus datos en Cloud Storage.

Para crear un bucket, haz lo siguiente:

1. Abre una ventana de terminal.

2. Usa el comando gcloud storage buckets create y un nombre único a nivel global para crear un bucket:

   gcloud storage buckets create gs://BUCKET_NAME/ --uniform-bucket-level-access

   Reemplaza BUCKET_NAME por un nombre para tu bucket.

   Precaución: No incluyas información sensible en el nombre del bucket, ya que el espacio de nombres del bucket es global y tiene visibilidad pública.
   Consulta los requisitos para nombrar bucket buckets.

   • Los nombres de los depósitos solo pueden contener letras en minúscula, caracteres numéricos, guiones (-), guiones bajos (_) y puntos (.). No se permiten espacios. Los nombres que contienen puntos se deben verificar.
   • Deben comenzar y terminar con un número o una letra.
   • Pueden contener entre 3 y 63 caracteres. Los nombres que contienen puntos pueden contener hasta 222 caracteres, pero cada componente separado por puntos no puede tener más de 63 caracteres.
   • No se pueden representar como una dirección IP en notación decimal con puntos (por ejemplo, 192.168.5.4).
   • No pueden comenzar con el prefijo "goog".
   • No pueden contener “google” o errores ortográficos, como “g00gle”.

   Si se completa correctamente, el comando muestra una respuesta como la siguiente:

   Creating gs://my-awesome-bucket/...

   Si otra persona o tú ya están usando el nombre de bucket que elegiste, el comando mostrará una respuesta como ServiceException: 409 Bucket my-awesome-bucket already exists. Vuelve a intentarlo con un nombre de bucket diferente.

Acabas de crear un bucket para almacenar datos.

Sube un objeto al bucket

1. Guarda la siguiente imagen en tu computadora, por ejemplo, en el escritorio.

   

   Nota: Si usas Cloud Shell o una instancia de Compute Engine, descarga la imagen con el siguiente comando: wget https://docs.cloud.google.com/storage/images/kitten.png

2. Usa el comando gcloud storage cp para copiar la imagen de la ubicación en la que la guardaste al bucket que creaste:

   gcloud storage cp Desktop/kitten.png gs://BUCKET_NAME

   Sugerencia: Cuando ingreses el nombre del bucket, puedes usar la tecla de tabulación para completarlo automáticamente.

   Si se completa correctamente, el comando muestra una respuesta como la siguiente:

   Copying file://Desktop/kitten.png to gs://my-awesome-bucket/kitten.png
     Completed files 1/1 | 8.6kiB/8.6kiB

   Almacenaste un objeto en tu bucket.

Descarga el objeto del bucket

1. Usa el comando gcloud storage cp para descargar la imagen que almacenaste en el bucket en algún lugar de tu computadora, como el escritorio:

   gcloud storage cp gs://BUCKET_NAME/kitten.png Desktop/kitten2.png

   Si se completa correctamente, el comando muestra una respuesta como la siguiente:

   Copying gs://my-awesome-bucket/kitten.png to file://Desktop/kitten2.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

   Descargaste un objeto desde tu bucket.

Copia el objeto a una carpeta simulada en el bucket

1. Usa el comando gcloud storage cp para crear una carpeta simulada y copiar la imagen en ella:

   gcloud storage cp gs://BUCKET_NAME/kitten.png gs://BUCKET_NAME/quickstart-folder/kitten3.png

   Nota: Las carpetas simuladas en Cloud Storage tienen limitaciones en comparación con los sistemas de archivos locales o las carpetas en buckets que tienen habilitado el espacio de nombres jerárquico, pero se admiten muchas de las mismas operaciones.

   Si se completa correctamente, el comando muestra una respuesta como la siguiente:

   Copying gs://my-awesome-bucket/kitten.png to gs://my-awesome-bucket/quickstart-folder/kitten3.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

   Acabas de copiar tu imagen en una carpeta simulada nueva del bucket.

Enumera los contenidos de un bucket

1. Usa el comando gcloud storage ls para mostrar el contenido en el nivel superior del bucket:

   gcloud storage ls gs://BUCKET_NAME

   Si se completa correctamente, el comando muestra una respuesta como la siguiente:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/quickstart-folder/

   Ya viste los contenidos en el nivel superior de tu bucket.

Muestra los detalles de un objeto

1. Usa el comando gcloud storage ls con la marca --long para obtener detalles sobre una de las imágenes:

   gcloud storage ls gs://BUCKET_NAME/kitten.png --long

   Si se completa correctamente, el comando muestra una respuesta como la siguiente:

   8775  2026-01-21T01:22:17Z  gs://srs-bucketcli/kitten.png
   TOTAL: 1 objects, 8775 bytes (8.57kiB)

   Acabas de obtener información sobre el tamaño y la fecha de creación de la imagen.

Haz que los objetos sean de acceso público

1. Usa el comando gcloud storage buckets add-iam-policy-binding a fin de otorgar a todos los usuarios permiso para leer las imágenes almacenadas en el bucket:

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer

   El comando es exitoso si tu respuesta contiene lo siguiente:

   bindings:
     - members:
       - allUsers
       role: roles/storage.objectViewer
   

   Ahora cualquiera puede obtener las imágenes.

2. Para quitar este acceso, usa el siguiente comando:

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer

   El comando es exitoso si no se muestra ningún error.

   Quitaste el acceso público a las imágenes del bucket.

Nota: Después de quitar el acceso público, es posible que aún puedas acceder a una versión en caché de tus imágenes durante un tiempo.

Otorga acceso a tu bucket

1. Usa el comando gcloud storage buckets add-iam-policy-binding a fin de dar permiso a una dirección de correo electrónico específica para que agregue objetos a tu bucket:

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=user:[e-mail] --role=roles/storage.objectCreator

   El comando es exitoso si tu respuesta contiene lo siguiente:

   bindings:
     - members:
       - user:[e-mail]
       role: roles/storage.objectCreator
   

   Ahora este usuario puede agregar elementos a tu bucket.

2. Para quitar este permiso, usa el siguiente comando:

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=user:[e-mail] --role=roles/storage.objectCreator

   El comando es exitoso si no se muestra ningún error.

   Le quitaste al usuario el acceso a este bucket.

Borra un objeto

1. Usa el comando gcloud storage rm para borrar una de las imágenes:

   gcloud storage rm gs://BUCKET_NAME/kitten.png

   Si se completa correctamente, el comando muestra una respuesta como la siguiente:

   Removing gs://my-awesome-bucket/kitten.png...

   Esta copia de la imagen ya no se almacena en Cloud Storage (aunque la copia que creaste en la carpeta simulada quickstart-folder/ todavía existe).

Realiza una limpieza

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página, borra el proyecto de Google Cloud que tiene los recursos.

1. Usa el comando gcloud storage rm con la marca --recursive para borrar el bucket y su contenido:

   gcloud storage rm gs://BUCKET_NAME --recursive

   Si se completa correctamente, el comando muestra una respuesta como la siguiente:

   Removing objects:
   Removing gs://my-awesome-bucket/quickstart-folder/kitten3.png#1768960201129254
     Completed 1/1
   Removing buckets:
   Removing gs://my-awesome-bucket/...
     Completed 1/1

   Se borraron tu bucket y su contenido.

¿Qué sigue?

• Sigue la guía de inicio rápido de Cloud Storage con la Google Cloud consola.
• Lee la descripción general del producto Cloud Storage.
• Obtén más información sobre los precios de Cloud Storage.
• Consulta las páginas de referencia de los comandos de gcloud CLI. Por ejemplo:
  • Crea buckets (buckets create)
  • Subir, descargar y copiar objetos (cp)
  • Enumera buckets y objetos (ls)
  • Agregar acceso a buckets (buckets add-iam-policy-binding)
  • Borra objetos y buckets (rm)