Google Cloud Platform
Hide
Google Cloud Storage
Write Feedback
  • Fast, scalable, highly available object store. Store your data with pay-as-you-go pricing that scales as your needs grow. Objects can be terabytes in size and stored in the United States, European Union, or Asia.

  • Your data in the cloud. Access your data with an HTTP API, a web-based interface, a command line tool, or one of many language libraries. Serve static data directly from Cloud Storage or store data that you can use with App Engine, Compute Engine, BigQuery, Cloud SQL, and Prediction API.

  • Easy, flexible authentication and sharing. Supports OAuth 2.0 authentication, individual, project, or group-level access controls, and customizable default object ACLs.

Try it now

Sign up

  1. If you don't already have one, sign up for a Google account.
  2. Create a Google Cloud Storage enabled project via the Google Developers Console.

Install gsutil

gsutil is a command line tool that you can use to access Google Cloud Storage. It requires Python 2.6.x or 2.7.x.

Installing on Linux or Mac OS X


  1. Download and install gsutil.

    Download and extract gsutil into your HOME directory using the following command: 

    $ curl https://storage.googleapis.com/pub/gsutil.tar.gz | tar xvz -C "$HOME"
  2. Add gsutil to your path.

    Add the following line to your ~/.bashrc file on Linux or to your ~/.bash_profile on Mac OS X, and restart your terminal for the changes to take effect. 

    export PATH="$PATH:~/gsutil"
  3. Authenticate to the Google Cloud platform.

    When prompted for a project ID, use the one you created in Step 1. 

    $ gsutil config

Installing on Windows


  1. Download and install Python.

    We recommend that you install Python in its default location (e.g., C:\Python27).

  2. Download and extract the gsutil archive.

    Download the gsutil archive, and then extract it to your root directory (e.g., C:\gsutil).

  3. Open a command window and modify the PATH variable temporarily to add the location where you installed Python. 
    set PATH=%PATH%;C:\Python27
  4. In the same command window, change the directory to where gsutil is installed, and authenticate to the Google Cloud platform.

    When prompted for a project ID, use the one you created in Step 1. 

    C:
cd \gsutil
python gsutil config

Create a Google Cloud Storage bucket using gsutil

  1. Create a bucket. 
    $ gsutil mb gs://<bucket-name>
  2. Upload some data to the bucket. 
    $ echo 'hello world' > foo.txt
$ gsutil cp foo.txt gs://<bucket-name>
  3. View the contents of the bucket. 
    $ gsutil ls gs://<bucket-name>
  4. Download and output the data. 
    $ gsutil cp gs://<bucket-name>/foo.txt -

What next?

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies.