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. 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

  1. Accede a tu Cuenta de Google.

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

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

    Ir a la página de selección de proyecto

  3. Asegúrate de tener habilitada la facturación para tu proyecto de Google Cloud Platform. Obtén información sobre cómo confirmar que tienes habilitada la facturación para tu proyecto.

  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 la 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 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 un objeto de tu depósito

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

    Copiaste tu objeto en una carpeta nueva de tu depósito.

Enumera el contenido de un depósito o una carpeta

  1. Usa el comando gsutil ls para enumerar el contenido en el nivel superior de tu 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/

    Viste los contenidos en el nivel superior de tu depósito.

Enumera los detalles de un objeto

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

    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)

    Obtuviste 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 gsutil acl ch para otorgar a todos los usuarios permiso de lectura sobre 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

    Quitaste el acceso público a este objeto.

Otorga acceso a tu depósito

  1. Usa el comando gsutil iam ch para dar permiso a una dirección de correo electrónico específica a fin de 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.

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