Hide
Google Cloud Storage

Regional Buckets

Regional Buckets allow you to place your Durable Reduced Availability data within the same region as your Compute Engine instances. All Cloud Storage and Compute Engine instances in a region share the same network fabric, reducing the latency between your Compute Engine instances and your objects and increasing the bandwidth. This gives you better performance for data-intensive computations, as opposed to the existing storage offerings, which spread your data over a much larger region to keep it closer to your users.

Objects placed in these buckets will be kept in the region on a best-effort basis. If necessary, the data may be kept elsewhere in the continent and moved back as capacity allows. You will not be able to directly query the exact data location. Since there are only a limited number of datacenters in each of these regions, only Durable Reduced Availability storage is currently available.

Terminology

Location
The location where your bucket and the objects in it are stored. Locations may be specified at a national/continental level (US, EU, ASIA) or at a regional level. For more information, see Bucket Locations.
Region
The region describes a more specific geographic location for your resources. When using Regional Bucket, choose a region that makes sense for your scenario. Usually, this will be the same region as the Compute Engine zones containing your instances. A region contains one or more highly-connected zones.
Zone
A zone is an isolated location within a region that is independent of other zones in the same region. You use zones to specify where your Compute Engine instances are deployed.

Creating a Regional Bucket

To create a Regional Bucket, specify one of the new regional locations instead of US, EU or ASIA. The regional locations are:

  • ASIA-EAST1 - Eastern Asia-Pacific
  • US-CENTRAL1 - Central United States
  • US-CENTRAL2 - Central United States
  • US-EAST1 - Eastern United States
  • US-EAST2 - Eastern United States
  • US-EAST3 - Eastern United States
  • US-WEST1 - Western United States

You can specify the bucket location when you create the bucket. The following examples create a DRA bucket in the US-WEST1 region.

Google Developers Console

  1. In the Developers Console, go to Storage > Cloud Storage > Storage browser.
  2. Click Add a bucket and specify:
    • A bucket name subject to the bucket name requirements.
    • The Storage class as Durable Reduced Availability Storage.
    • The location as United States.
    • The region as US-WEST1.

    New DRA bucket.

  3. Click Create.

gsutil

gsutil mb -c DRA -l US-WEST1 gs://<bucket-name>

Note that you must specify "-c DRA" because only Durable Reduced Availability storage is available for regional buckets.

JSON API

Using cURL and the JSON API.

curl -X POST --data-binary @dra.json \
     -H 'Content-Type: application/json' \
     -H "Authorization: Bearer <auth token>" \
     https://www.googleapis.com/storage/v1/b?project=<project-id>

Where the dra.json file contains the following information:

{
 "name": "<bucket-name>",
 "location": "US-WEST1",
 "storageClass": "DURABLE_REDUCED_AVAILABILITY"
}

You can get an authorization access token from the OAuth 2.0 Playground. Configure the playground to use your own OAuth credentials.

XML API

Using cURL and the XML API.

curl -X PUT --data-binary @dra.xml \
     -H "Authorization: Bearer <auth token>" \
     -H "x-goog-project-id: <project-id>" \
     https://storage.googleapis.com/<bucket-name>

Where the dra.xml file contains the following information:

<CreateBucketConfiguration>
   <LocationConstraint>US-WEST1</LocationConstraint>
   <StorageClass>DURABLE_REDUCED_AVAILABILITY</StorageClass>
</CreateBucketConfiguration>

You can get an authorization access token from the OAuth 2.0 Playground. Configure the playground to use your own OAuth credentials.

Using a Regional Bucket

You can access data in a Regional Bucket in the same exact ways you can access data in a Standard bucket. The same APIs, tools, and UI that are used for Standard Storage are also used for Nearline Storage including the XML API and JSON API, the command-line gsutil tool, the Google Developers Console, and the client libraries.

Changing bucket region

You cannot change a bucket's region (location) once it is created. But, you can create a new bucket in a new region and copy data to it. For more information, see Changing bucket location.