Skip to content

gsutil commands


gsutil is a CLI tool to work with data on Google Storage Service. Using the tool, you can query public data anonymously. However, to query private data, you need to authenticate. Gsutil can inherit the auth from gcloud CLI.

The general syntax to represent a bucket is:


You can have any number of nested sub-folders within a bucket.

Buckets in GCS are globally-unique, even for private buckets.


Adapted from

Creating a bucket

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

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

Uploading objects to a bucket

gsutil cp <path>/<file> gs://<bucket>/folder

Downloading objects from a bucket

gsutil cp gs://<bucket>/folder/file <local dest>/<path>

You can also copy content from one bucket / folder to another using the same command.

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

List contents of a bucket

gsutil ls gs://<bucket>

# returns

You can use -l flag for details.

Deleting objects

gsutil rm gs://<bucket>/file

You can use the -r recursive flag to remove folders, and even buckets.