Moving and Renaming Buckets

Although you can change the storage class associated with a bucket, you cannot directly change a bucket's name or location after it is created. If there is no data in the bucket, you can simply delete the bucket and create it again with a new name or in a new location. If the bucket has data in it, you can create a new bucket with a different name and, if desired, in a new location, then copy data from the old bucket to the new bucket. The steps below describe this process.

Important: Moving data between buckets may incur one or more of the following costs for transfers:

$0.01 per GB if transfer is between different regions in the same multi-regional location. For example, transfers between US-CENTRAL1 and US-EAST2 incur the stated charge.
$0.01 per GB if transfer is between a region and its parent multi-regional location.
A tiered charge if transfer is between multi-regional locations, same as egress pricing:
- $0.12 per GB 0-1 TB
- $0.11 per GB 1-10 TB
- $0.08 per GB 10+ TB
$0.01 per GB if transfer is out of the Nearline Storage class. An early deletion cost applies for data that is deleted that is less than 30 days old. See Google Cloud Storage Nearline Pricing for details.
$0.05 per GB if transfer is out of the Coldline Storage class. An early deletion cost applies for data that is deleted that is less than 90 days old. See Google Cloud Storage Coldline Pricing for details.

If your source and destinations buckets are in the same region or same location and you are not transferring out of Cloud Storage Nearline, then the transfer does not incur any cost. For more information and examples, see Pricing.

To move your data from one bucket to another:

Step 1) Create a new bucket

Console

Open the Cloud Storage browser in the Google Cloud Platform Console.
Open the Cloud Storage browser
Click Create bucket.
In the Create bucket dialog, specify:
- A Name subject to the bucket name requirements.
- The default Storage class for the bucket.
- A Location where the bucket data will be stored.
Click Create.

gsutil

Use the gsutil mb command, replacing [VALUES_IN_BRACKETS] with the appropriate values:

gsutil mb gs://[BUCKET_NAME]/

Set the following optional flags to have greater control over the creation of your bucket:

-p: specify the project with which your bucket will be associated.
-c: specify the default storage class of your bucket.
-l: specify the location of your bucket.

For example:

gsutil mb -p [PROJECT_NAME] -c [STORAGE_CLASS] -l [BUCKET_LOCATION] gs://[BUCKET_NAME]/

Client Libraries

C#

For more on installing and creating a Cloud Storage client, refer to Cloud Storage Client Libraries.

View on GitHub Feedback

private void CreateBucket(string bucketName)
{
    var storage = StorageClient.Create();
    storage.CreateBucket(s_projectId, bucketName);
    Console.WriteLine($"Created {bucketName}.");
}

Go

For more on installing and creating a Cloud Storage client, refer to Cloud Storage Client Libraries.

View on GitHub Feedback

bucket := client.Bucket(bucketName)
if err := bucket.Create(ctx, projectID, &storage.BucketAttrs{
	StorageClass: "COLDLINE",
	Location:     "asia",
}); err != nil {
	return err
}

Java

For more on installing and creating a Cloud Storage client, refer to Cloud Storage Client Libraries.

View on GitHub Feedback

Bucket bucket = storage.create(BucketInfo.newBuilder(bucketName)
    // See here for possible values: http://g.co/cloud/storage/docs/storage-classes
    .setStorageClass(StorageClass.COLDLINE)
    // Possible values: http://g.co/cloud/storage/docs/bucket-locations#location-mr
    .setLocation("asia")
    .build());

Node.js

For more on installing and creating a Cloud Storage client, refer to Cloud Storage Client Libraries.

View on GitHub Feedback

// Imports the Google Cloud client library
const Storage = require('@google-cloud/storage');

// The name of the bucket to create, e.g. "my-bucket"
// const bucketName = "my-bucket";

// Instantiates a client
const storage = Storage();

// Creates a new bucket
storage
  .createBucket(bucketName)
  .then(() => {
    console.log(`Bucket ${bucketName} created.`);
  })
  .catch((err) => {
    console.error('ERROR:', err);
  });

PHP

For more on installing and creating a Cloud Storage client, refer to Cloud Storage Client Libraries.

View on GitHub Feedback

use Google\Cloud\Storage\StorageClient;

/**
 * Create a Cloud Storage Bucket.
 *
 * @param string $bucketName name of the bucket to create.
 * @param string $options options for the new bucket.
 *
 * @return Google\Cloud\Storage\Bucket the newly created bucket.
 */
function create_bucket($bucketName, $options = [])
{
    $storage = new StorageClient();
    $bucket = $storage->createBucket($bucketName, $options);
    printf('Bucket created: %s' . PHP_EOL, $bucket->name());
}

Python

For more on installing and creating a Cloud Storage client, refer to Cloud Storage Client Libraries.

View on GitHub Feedback

def create_bucket(bucket_name):
    """Creates a new bucket."""
    storage_client = storage.Client()
    bucket = storage_client.create_bucket(bucket_name)
    print('Bucket {} created'.format(bucket.name))

Ruby

For more on installing and creating a Cloud Storage client, refer to Cloud Storage Client Libraries.

View on GitHub Feedback

# project_id  = "Your Google Cloud project ID"
# bucket_name = "Name of Google Cloud Storage bucket to create"

require "google/cloud/storage"

storage = Google::Cloud::Storage.new project: project_id
bucket  = storage.create_bucket bucket_name

puts "Created bucket: #{bucket.name}"

REST APIS

JSON API

For information on available storage classes to set as the default for your bucket, see Storage Classes.

Get an authorization access token from the OAuth 2.0 Playground. Configure the playground to use your own OAuth credentials.
Create a .json file that contains the following information, replacing [VALUES_IN_BRACKETS] with the appropriate values:

{
  "name": "[BUCKET_NAME]",
  "location": "[BUCKET_LOCATION]",
  "storageClass": "[STORAGE_CLASS]"
}

Use cURL to call the JSON API, replacing [VALUES_IN_BRACKETS] with the appropriate values:

curl -X POST --data-binary @[JSON_FILE_NAME].json \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     -H "Content-Type: application/json" \
     "https://www.googleapis.com/storage/v1/b?project=[PROJECT_ID]"

XML API

For information on available storage classes to set as the default for your bucket, see Storage Classes.

Get an authorization access token from the OAuth 2.0 Playground. Configure the playground to use your own OAuth credentials.
Create a .xml file that contains the following information, replacing [VALUES_IN_BRACKETS] with the appropriate values:

<CreateBucketConfiguration>
   <LocationConstraint>[BUCKET_LOCATION]</LocationConstraint>
   <StorageClass>[STORAGE_CLASS]</StorageClass>
</CreateBucketConfiguration>

Use cURL to call the XML API, replacing [VALUES_IN_BRACKETS] with the appropriate values:

curl -X PUT --data-binary @[XML_FILE_NAME].xml \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     -H "x-goog-project-id: [PROJECT_ID]" \
     "https://storage.googleapis.com/[BUCKET_NAME]"

Step 2) Copy files from your old bucket to your new bucket

Console

Use the Cloud Storage Transfer Service from within Google Cloud Platform Console to copy data from one Cloud Storage bucket to another:

Open the Transfer page in the Google Cloud Platform Console.
Open the Transfer page
Click **Create Transfer.
Follow the step-by-step walkthrough in the create transfer page, clicking Continue as you complete each step:
- Select Source: Use Google Cloud Storage Bucket as your selected source, and click Browse to find and select the bucket you want to move your files out of.
- Select Destination: Click Browse to find and select the bucket you want to move your files into.
  Additionally, select the checkbox Delete source objects after the transfer completes.
- Configure Transfer: You can ignore this section.
After you complete the step-by-step walkthrough, click Create.
This begins the process of copying files from your old bucket into your new one. This process may take some time; however, after you click Create, you can navigate away from the Google Cloud Platform Console.

To view the transfer's progress: Open the Transfer page in the Google Cloud Platform Console.

Open the Transfer page

gsutil

Make sure you have at least gsutil 4.12 installed.
Use the gsutil cp command, with the -r option, to recursively copy all your files from the source bucket to the destination bucket. Replace [VALUES_IN_BRACKETS] with the appropriate values:
```
gsutil cp -r gs://[SOURCE_BUCKET] gs://[DESTINATION_BUCKET]
```

REST APIs

JSON API

Use the JSON API's rewrite method to copy data in limited-sized chunks over multiple requests. When doing so, you must loop and call the rewrite method until all the data are moved:

Use cURL and the JSON API rewrite method to copy data from a source bucket to a destination bucket, replacing [VALUES_IN_BRACKETS] with the appropriate values:

curl -X POST -H "Authorization: Bearer [OAUTH2_TOKEN]" \
   "https://www.googleapis.com/storage/v1/b/[SOURCE_BUCKET]/o/[OBJECT_NAME]/rewriteTo/b/[DESTINATION_BUCKET]/o/[OBJECT_NAME]"

If the object is, for example, 10 GB in size, the response to this request looks similar to the following example:

{
  "kind": "storage#rewriteResponse",
  "totalBytesRewritten": 1048576,
  "objectSize": 10000000000,
  "done": false,
  "rewriteToken": [TOKEN_VALUE]
}

Use the rewriteToken in a subsequent request to continue copying data, replacing [VALUES_IN_BRACKETS] with the appropriate values:

curl -X POST -H "Authorization: Bearer [OAUTH2_TOKEN]" \
   -H "Content-Type: application/json" \
   -d '{"rewriteToken": "[TOKEN_VALUE]"}' \
   "https://www.googleapis.com/storage/v1/b/[SOURCE_BUCKET]/o/[OBJECT_NAME]/rewriteTo/b/[DESTINATION_BUCKET]/o/[OBJECT_NAME]"

When all of the data is copied, the last response has a done property equal to true, there is no rewriteToken property, and the metadata of the copied-to object is included in the resource property.

{
  "kind": "storage#rewriteResponse",
  "totalBytesRewritten": 10000000000,
  "objectSize": 10000000000,
  "done": true,
  "resource": objects Resource
}

Step 3) Delete the files from your old bucket

Console

You don't need to do anything to delete the files from your old bucket: as part of copying files using the Transfer Service, old files are deleted automatically (this assumes you selected the "Delete source objects after the transfer completes" checkbox).

gsutil

Use the gsutil rm command, with the -r option, to recursively delete all your files from the source bucket, as well as the source bucket itself. Replace [VALUES_IN_BRACKETS] with the appropriate values:

gsutil rm -r gs://[SOURCE_BUCKET]

Or, to delete the files but keep the source bucket:

gsutil rm -r gs://[SOURCE_BUCKET]/**

REST APIs

JSON API

Use cURL and the JSON API delete method to remove the original version of your data with the following command, replacing [VALUES_IN_BRACKETS] with the appropriate values:
```
curl -X DELETE -H "Authorization: Bearer [OAUTH2_TOKEN]" \
   https://www.googleapis.com/storage/v1/b/[SOURCE_BUCKET]/o/[OBJECT_NAME]
```

If successful, the method returns an empty response.

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. Java is a registered trademark of Oracle and/or its affiliates.

Last updated May 11, 2017.

Moving and Renaming Buckets

Step 1) Create a new bucket

Console

gsutil

Client Libraries

C#

Go

Java

Node.js

PHP

Python

Ruby

REST APIS

JSON API

XML API

Step 2) Copy files from your old bucket to your new bucket

Console

gsutil

REST APIs

JSON API

Step 3) Delete the files from your old bucket

Console

gsutil

REST APIs

JSON API

Send feedback about...