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. En esta guía de inicio rápido, por lo general, se usa menos de $0.01 USD en recursos de Cloud Storage.

Antes de comenzar

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. In the GCP Console, go to the Manage resources page and create a project.

    Go to the Manage resources page

  3. Asegúrate de tener habilitada la facturación para tu proyecto.

    Aprende a habilitar la facturación

  4. Instala el SDK de Cloud.

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

  5. Instala Python 2.7.

    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 terminal.
  2. Usa el comando gsutil mb y un nombre único para crear un depósito:
    gsutil mb -l us-east1 gs://my-awesome-bucket/
    

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

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

    Creating gs://my-awesome-bucket/...
    
  3. Tu depósito está listo y ya puedes comenzar a almacenar tu contenido.

Sube un objeto a tu depósito

Imagen de un gatito.

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

  2. Usa el comando de gsutil cp para copiar la imagen de la ubicación donde la guardaste en el 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

    Ya almacenaste un objeto en tu depósito.

Descarga un objeto de tu depósito

  1. Usa el comando de gsutil cp para descargar la imagen que almacenaste en tu depósito en alguna parte 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

    Ya descargaste un objeto desde tu depósito.

Copia un 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

    Ya copiaste tu objeto en una carpeta nueva en tu depósito.

Enumera el contenido de un depósito o una carpeta

  1. Usa el comando de gsutil ls para enumerar los contenidos en el nivel superior de tu depósito:

    gsutil ls gs://my-awesome-bucket

    Si se ejecuta correctamente, 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.

Enumera los detalles de un objeto

  1. Usa el comando de gsutil ls, con la marca -l para obtener algunos detalles sobre un objeto:

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

    Si se ejecuta correctamente, 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 del objeto.

Permite el acceso público a tu objeto

  1. Usa el comando de gsutil acl ch a fin de otorgar a todos los usuarios permisos de lectura para el objeto almacenado en tu depósito:

    gsutil acl ch -u AllUsers:R gs://my-awesome-bucket/kitten.png

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

    Updated ACL on gs://my-awesome-bucket/kitten.png

    Ahora cualquier persona puede obtener tu objeto.

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

    gsutil acl ch -d AllUsers gs://my-awesome-bucket/kitten.png

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

    Updated ACL on gs://my-awesome-bucket/kitten.png

    Ya quitaste el acceso público a este objeto.

Otorga acceso a tu depósito

  1. Usa el comando gsutil iam ch a fin de otorgar permiso a una dirección de correo electrónico específica para leer y escribir objetos en tu 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.

    Ya le quitaste al usuario el acceso a este depósito.

Borra objetos

  1. Usa el comando gsutil rm para borrar un objeto:

    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 del objeto ya no está almacenada en Cloud Storage (a pesar de que la copia que hiciste en la carpeta just-a-folder/ todavía existe).

Limpieza

Para evitar que se apliquen cargos a tu cuenta de GCP por los recursos que se usan en esta guía de inicio rápido, realiza los siguientes pasos:

  1. Abre una ventana de terminal (si no está abierta).
  2. Usa el rm command de gsutil con la marca -r para borrar el depósito y todo lo que haya adentro.

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

    Si se ejecuta correctamente, 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.

Pasos siguientes

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.