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 la página de selección de proyectos de Cloud Console, haz clic en Crear para comenzar a crear un proyecto de Cloud nuevo.

    Ir a la página de selección 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.

Crea un depósito

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

Para crear un depósito, haz lo siguiente:

  1. Abre una ventana de la terminal.
  2. Usa el comando de gsutil mb y un nombre único para crear un depósito:

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

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

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

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

Acabas de crear un depósito para almacenar datos.

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

Vuelve a intentarlo con otro nombre de depósito.

Sube un objeto al depósito

Imagen de un gatito

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

  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 depósito.

Descarga el objeto del depósito

  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 depósito.

Copia el objeto a una carpeta del depósito

  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

    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 depósito.

Muestra el contenido de un depósito 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 depósito.

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 depósito.

Otorga acceso a tu depósito

  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:jane@gmail.com: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 depósito.

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

    gsutil iam ch -d user:jane@gmail.com: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 depósito.

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 depósito y su contenido.

Próximos pasos