Google Cloud Storage: Store Your Data in Google's Cloud

1. 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 Cloud Console .

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

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

4. What next?

   • Review the Overview page.
   • Try Getting Started: Using the gsutil Tool .
   • Try Getting Started: Using the Developers Console .
   • Read the Developer Guide .
   • Contact Google for high-volume accounts.

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 .