Guía de inicio rápido: Usa la herramienta de gsutil

En esta página, se muestra cómo realizar tareas básicas en Cloud Storage con la herramienta de línea de comandos de gsutil.

Los costos se generan en Cloud Storage según los recursos que usas. Este inicio rápido normalmente usa menos de $0.01 en recursos de Cloud Storage.

Antes de comenzar

1. Accede a tu Cuenta de Google.

   Si todavía no tienes una cuenta, regístrate para obtener una nueva.

2. En Google Cloud Console, en la página de selección de proyecto, haz clic en Crear para comenzar a crear un proyecto de Google Cloud nuevo.

   Ir a la página del selector de proyectos

3. Comprueba que la facturación esté habilitada en tu proyecto.

   Descubre cómo puedes habilitar la facturación

4. Instala el SDK de Cloud.

   Cuando se te solicite, elige el proyecto que creaste antes.

5. Instala Python 3.8.

   Si usas Windows y dejaste la casilla de verificación correspondiente seleccionada cuando instalaste el SDK de Cloud, esto se hizo de forma automática.

Nota: Si usas Cloud Shell o una instancia de Compute Engine, Python y gsutil ya están preinstalados y autenticados. Si tu instancia de Compute Engine está configurada sin un alcance de cuenta de servicio para Cloud Storage, ejecuta gsutil config y sigue las instrucciones.

Nota: Si usas Windows y no instalaste gsutil como parte del SDK de Cloud, debes anteponer python a cada comando gsutil (por ejemplo, python gsutil mb gs://my-awesome-bucket). Para obtener más información, consulta las Preguntas frecuentes sobre Python en Windows.

Crea un bucket

Los depósitos son los contenedores básicos que conservan tus datos en Cloud Storage.

Para crear un bucket, haz lo siguiente:

1. Abre una ventana de la terminal.

2. Usa el comando de gsutil mb y un nombre único para crear un bucket:

   gsutil mb -b on -l us-east1 gs://my-awesome-bucket/

   Esto usa un bucket llamado “my-awesome-bucket”. Debes elegir tu propio nombre de bucket que sea único a nivel global.

   Consulta los requisitos para nombrar los buckets.

   • Los nombres de los buckets deben contener solo letras minúsculas, números, 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”.
   Precaución: No incluyas información sensible en el nombre del depósito, ya que su espacio de nombres es global y tiene visibilidad pública.

   Si se ejecuta de forma correcta, el comando mostrará lo siguiente:

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

Acabas de crear un bucket para almacenar datos.

Nota: Si otra persona o tú ya están usando el nombre del depósito que elegiste, el comando mostrará la siguiente información:

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Vuelve a intentarlo con otro nombre de bucket.

Sube un objeto al bucket

1. Haz clic derecho sobre la imagen anterior y guárdala en algún lugar de tu computadora, como el escritorio.

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

2. Usa el comando gsutil cp para copiar la imagen de la ubicación en la que la guardaste al depósito que creaste:

   gsutil cp Desktop/kitten.png gs://my-awesome-bucket

   Si se ejecuta correctamente, el comando mostrará lo siguiente:

   Copying file://Desktop/kitten.png [Content-Type=image/png]...
   Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
   Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

   Almacenaste un objeto en tu bucket.

Nota: Cuando ingreses el nombre del depósito, puedes usar la tecla de tabulación para completarlo de forma automática.

Descarga el objeto del bucket

1. Usa el comando gsutil cp para descargar la imagen que almacenaste en el depósito en algún lugar de tu computadora, como el escritorio:

   gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

   Si se ejecuta correctamente, el comando mostrará lo siguiente:

   Copying gs://my-awesome-bucket/kitten.png...
   Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
   Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

   Descargaste un objeto desde tu bucket.

Copia el objeto a una carpeta del bucket

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

   gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

   Nota: Las carpetas en Cloud Storage tienen limitaciones en comparación con los sistemas de archivos locales, pero se admiten muchas de las mismas operaciones.

   Si se ejecuta correctamente, el comando mostrará lo siguiente:

   Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
   Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

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

Muestra el contenido de un bucket o una carpeta

1. Usa el comando gsutil ls para mostrar el contenido en el nivel superior del depósito:

   gsutil ls gs://my-awesome-bucket

   Si tiene éxito, el comando mostrará un mensaje similar a este:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/just-a-folder/

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

Muestra los detalles de un objeto

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

   gsutil ls -l gs://my-awesome-bucket/kitten.png

   Si tiene éxito, el comando mostrará un mensaje similar a este:

   2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
   TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

   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 gsutil iam ch a fin de otorgar a todos los usuarios permiso para leer las imágenes almacenadas en el depósito:

   gsutil iam ch allUsers:objectViewer gs://my-awesome-bucket

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

   Ahora cualquiera puede obtener las imágenes.

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

   gsutil iam ch -d allUsers:objectViewer gs://my-awesome-bucket

   El comando resulta 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 una de las imágenes durante un tiempo.

Otorga acceso a tu bucket

1. Usa el comando gsutil iam ch a fin de dar permiso a una dirección de correo electrónico específica para que lea y escriba objetos en el depósito:

   gsutil iam ch user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

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

   Ahora alguien más puede colocar objetos y ver lo que hay en tu bucket.

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

   gsutil iam ch -d user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   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 gsutil rm para borrar una de las imágenes:

   gsutil rm gs://my-awesome-bucket/kitten.png

   Si se ejecuta correctamente, el comando mostrará lo 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 just-a-folder/ todavía existe).

Realiza una limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido.

1. Abre una ventana de la terminal (si no está abierta).

2. Usa rm command de gsutil con la marca -r para borrar el depósito y su contenido:

   gsutil rm -r gs://my-awesome-bucket

   Si tiene éxito, el comando mostrará un mensaje similar a este:

   Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
   Removing gs://my-awesome-bucket/...

   Se borraron tu bucket y su contenido.

Próximos pasos

• Lee la guía de inicio rápido de Cloud Storage con Google Cloud Console.
• Revisa las guías disponibles para completar tareas en Cloud Storage.
• Obtén información sobre los términos clave en Cloud Storage.
• Obtén más información sobre la estructura de precios para Cloud Storage.
• Consulta las páginas de referencia de los comandos de gsutil, como crea un bucket (mb), copia (cp), lista (ls ), administración de identidades y accesos (iam) y quita (rm).