Setting Up Google Cloud Storage

You can use a Cloud Storage bucket to store and serve files, such as movies or images or other static content. This document describes how to set up your environment to use the Google Cloud Storage client library.

For more information about Cloud Storage, see the Cloud Storage documentation.

Setting up your project

Follow the instructions in "Hello, World!" for Java on App Engine to set up your environment and project, and to understand how Java apps are structured in App Engine. Write down and save your project ID for use with your application.

Activating a Cloud Storage bucket

To use Cloud Storage, you'll need to activate at least one bucket. You might want to use the default bucket which provides the first 5GB of storage for free. You can always activate and use another Cloud Storage bucket if you want, but only the default bucket includes the first 5GB of storage for free. The default bucket also includes a free quota for Cloud Storage I/O operations. See Pricing, quotas, and limits for more details.

To activate the default Cloud Storage bucket for your app:

  1. Click Create under Default Cloud Storage Bucket in the App Engine settings page for your project. Notice the name of this bucket: it is in the form <project-id>.appspot.com.

  2. If you need more storage than the 5GB limit, you can increase this by enabling billing for your project, making this a paid bucket. You will be charged for storage over the 5GB limit.

If you want to activate one or more paid buckets, follow the instructions under Creating a bucket to activate them.

Setting bucket and object permissions

By default, when you create a bucket for your project, your app has all the permissions required to read and write to it.

If you want to set permissions to allow other users to access the bucket and its contents, see Setting bucket permissions and Setting object permissions.

Downloading the client library

You can download the library using popular tools like Apache Maven, Apache Ivy, or Git, or you can download the library manually from the Maven repository. Choose your preferred method:

Git

If you have Git installed, you can clone the Google Cloud Storage client library's GitHub repository as follows:

git clone https://github.com/GoogleCloudPlatform/appengine-gcs-client.git

Maven

Maven users should include the following in their application's pom.xml file:

<dependency>
    <groupId>com.google.appengine.tools</groupId>
    <artifactId>appengine-gcs-client</artifactId>
    <version>RELEASE</version>
</dependency>

Note that RELEASE is a literal value that results in the download of the latest client library for your project.

Ivy

Ivy users should include the following in their application's ivy.xml file:

<dependency org="com.google.appengine.tools"
            name="appengine-gcs-client"
            rev="latest.integration" />

Manual download

Visit the library's Maven repository and download the latest class, source, and JavaDoc JAR files:

In addition, you will need to download the following dependencies and include them in your application:

Using the client library with the development app server

You can use the client library with the development server.

Pricing, quotas, and limits

There are no bandwidth charges associated with making Google Cloud Storage client library calls to Cloud Storage. However, there are operations charges; because the calls count against your URL fetch quota, as the library uses the URL Fetch service to interact with Cloud Storage. And There are operations and storage charges, however,

Notice that Google Cloud Storage is a pay-to-use service; you will be charged according to the Cloud Storage price sheet.

Alternative ways to access Cloud Storage

Instead of using the client library, you could use the following:

  • Cloud Storage REST API. This could be a good choice if you need a specific feature not provided in the client library. However, this isn't compatible with the development server.
  • Cloud Storage Browser in the Google Cloud Platform Console. Useful for uploading objects quickly.
  • gsutil. A command line tool.

Send feedback about...

App Engine standard environment for Java