移动和重命名存储分区

创建存储分区时，您将永久定义其名称、地理位置以及所属的项目。不过，您可以有效移动或重命名您的存储分区：

如果旧的存储分区中没有数据，只需删除存储分区，然后使用新名称、在新位置或者新项目中重新创建一个存储分区即可。
如果旧的存储分区中有数据，请使用所需的名称、位置和/或项目创建一个新的存储分区，然后将旧存储分区中的数据复制到新的存储分区，再删除旧存储分区及其中的内容。以下步骤对此过程进行了说明。

请注意，如果您希望新的存储分区使用旧存储分区的名称，则必须将数据移动两次：先将数据暂时保存在一个中间存储分区，然后删除原来的存储分区，最后使用该名称创建新的存储分区。

如需将数据从一个存储分区移到另一个存储分区，请执行以下操作：

第 1 步：创建新存储分区

控制台

在 Google Cloud Console 中打开 Cloud Storage 浏览器。
打开 Cloud Storage 浏览器
点击创建存储分区，打开存储分区创建表单。

新存储分区。

输入您的存储分区信息，然后点击继续以完成各个步骤：

根据存储分区名称要求指定一个名称。
为存储分区选择默认存储类别。默认情况下，系统会为上传到该存储分区的所有对象分配该默认存储类别。接下来，选择一个要用于永久存储该存储分区数据的位置。
注意：右侧窗格中的每月费用估算面板会根据您选择的存储类别和位置以及您预期的数据大小和操作，估算存储分区的每月费用。
选择访问权限控制模型，确定如何控制对存储分区对象的访问权限。
您也可以选择添加存储分区标签，设置保留政策，并选择加密方法。

点击完成。

请参阅问题排查，了解如何获取有关 Cloud Storage 浏览器中失败操作的详细错误信息。

gsutil

使用 gsutil mb 命令：

gsutil mb gs://[BUCKET_NAME]/

其中：

[BUCKET_NAME] 是您要为自己的存储分区指定的名称（须遵循命名要求），例如 my-bucket。

设置以下可选标志，以便更好地控制存储分区的创建：

-p：指定将与您的存储分区相关联的项目，例如 my-project。
-c：指定存储分区的默认存储类别，例如 NEARLINE。
-l：指定存储分区的位置，例如 US-EAST1。
-b：为存储分区启用统一存储分区级访问权限。

例如：

  gsutil mb -p [PROJECT_ID] -c [STORAGE_CLASS] -l [BUCKET_LOCATION] -b on gs://[BUCKET_NAME]/

代码示例

C++

如需了解详情，请参阅 Cloud Storage C++ API 参考文档。

在 GitHub 上查看反馈

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name) {
  StatusOr<gcs::BucketMetadata> bucket_metadata =
      client.CreateBucket(bucket_name, gcs::BucketMetadata());

  if (!bucket_metadata) {
    throw std::runtime_error(bucket_metadata.status().message());
  }

  std::cout << "Bucket " << bucket_metadata->name() << " created."
            << "\nFull Metadata: " << *bucket_metadata << "\n";
}

C#

如需了解详情，请参阅 Cloud Storage C# API 参考文档。

在 GitHub 上查看反馈

public static Bucket StorageCreateBucket(string projectId, string bucketName)
{
    var storage = StorageClient.Create();
    var bucket = storage.CreateBucket(projectId, bucketName);
    Console.WriteLine($"Created {bucketName}.");
    return bucket;
}

Go

如需了解详情，请参阅 Cloud Storage Go API 参考文档。

在 GitHub 上查看反馈

ctx := context.Background()
bucket := client.Bucket(bucketName)

ctx, cancel := context.WithTimeout(ctx, time.Second*10)
defer cancel()
if err := bucket.Create(ctx, projectID, &storage.BucketAttrs{
	StorageClass: "COLDLINE",
	Location:     "asia",
}); err != nil {
	return err
}

Java

如需了解详情，请参阅 Cloud Storage Java API 参考文档。

在 GitHub 上查看反馈

import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.BucketInfo;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageClass;
import com.google.cloud.storage.StorageOptions;

public class CreateBucketWithStorageClassAndLocation {
  public static void createBucketWithStorageClassAndLocation(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID to give your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();

    // See the StorageClass documentation for other valid storage classes:
    // https://googleapis.dev/java/google-cloud-clients/latest/com/google/cloud/storage/StorageClass.html
    StorageClass storageClass = StorageClass.COLDLINE;

    // See this documentation for other valid locations:
    // http://g.co/cloud/storage/docs/bucket-locations#location-mr
    String location = "asia";

    Bucket bucket =
        storage.create(
            BucketInfo.newBuilder(bucketName)
                .setStorageClass(storageClass)
                .setLocation(location)
                .build());

    System.out.println(
        "Created bucket "
            + bucket.getName()
            + " in "
            + bucket.getLocation()
            + " with storage class "
            + bucket.getStorageClass());
  }
}

Node.js

如需了解详情，请参阅 Cloud Storage Node.js API 参考文档。

在 GitHub 上查看反馈

/**
 * TODO(developer): Uncomment the following line before running the sample.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';

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

// Creates a client
const storage = new Storage();

async function createBucket() {
  // Creates a new bucket in the Asia region with the coldline default storage
  // class. Leave the second argument blank for default settings.
  //
  // For default values see: https://cloud.google.com/storage/docs/locations and
  // https://cloud.google.com/storage/docs/storage-classes

  const [bucket] = await storage.createBucket(bucketName, {
    location: 'ASIA',
    storageClass: 'COLDLINE',
  });

  console.log(`Bucket ${bucket.name} created.`);
}

createBucket().catch(console.error);

PHP

如需了解详情，请参阅 Cloud Storage PHP API 参考文档。

在 GitHub 上查看反馈

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.
 *
 */
function create_bucket($bucketName, $options = [])
{
    $storage = new StorageClient();
    $bucket = $storage->createBucket($bucketName, $options);
    printf('Bucket created: %s' . PHP_EOL, $bucket->name());
}

Python

如需了解详情，请参阅 Cloud Storage Python API 参考文档。

在 GitHub 上查看反馈

from google.cloud import storage

def create_bucket(bucket_name):
    """Creates a new bucket."""
    # bucket_name = "your-new-bucket-name"

    storage_client = storage.Client()

    bucket = storage_client.create_bucket(bucket_name)

    print("Bucket {} created".format(bucket.name))

Ruby

如需了解详情，请参阅 Cloud Storage Ruby API 参考文档。

在 GitHub 上查看反馈

# bucket_name   = "Name of Google Cloud Storage bucket to create"
# location      = "Location of where to create Cloud Storage bucket"
# storage_class = "Storage class of Cloud Storage bucket"

require "google/cloud/storage"

storage = Google::Cloud::Storage.new
bucket  = storage.create_bucket bucket_name,
                                location:      location,
                                storage_class: storage_class

puts "Created bucket #{bucket.name} in #{location}" \
     " with #{storage_class} class"

REST API

JSON API

从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。
创建一个包含以下信息的 .json 文件：

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

其中：

[BUCKET_NAME] 是您要为自己的存储分区指定的名称（须遵循命名要求），例如 my-bucket。
[BUCKET_LOCATION] 是您要用于存储自己的存储分区对象数据的位置，例如 US-EAST1。
[STORAGE_CLASS] 是您存储分区的默认存储类别，例如 NEARLINE。

使用 cURL 调用 JSON API：
```
curl -X POST --data-binary @[JSON_FILE_NAME].json \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     -H "Content-Type: application/json" \
     "https://storage.googleapis.com/storage/v1/b?project=[PROJECT_ID]"
```
其中：
- [JSON_FILE_NAME] 是您在第 2 步中创建的 JSON 文件的名称。
- [OAUTH2_TOKEN] 是您在第 1 步中生成的访问令牌。
- [PROJECT_ID] 是将与您的存储分区相关联的项目的 ID，例如 my-project。

XML API

从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。
创建一个包含以下信息的 .xml 文件：

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

其中：

[BUCKET_LOCATION] 是您要用于存储自己的存储分区对象数据的位置，例如 US-EAST1。
[STORAGE_CLASS] 是您存储分区的默认存储类别，例如 NEARLINE。

使用 cURL 调用 XML API：
```
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]"
```
其中：
- [XML_FILE_NAME] 是您在第 2 步中创建的 XML 文件的名称。
- [OAUTH2_TOKEN] 是您在第 1 步中生成的访问令牌。
- [PROJECT_ID] 是将与您的存储分区相关联的项目的 ID，例如 my-project。
- [BUCKET_NAME] 是您要为自己的存储分区指定的名称（须遵循命名要求），例如 my-bucket。

第 2 步：将旧存储分区中的对象复制到新存储分区中

控制台

从 Google Cloud Console 中使用 Cloud Storage Transfer Service，将数据从一个 Cloud Storage 存储分区复制到另一个：

在 Google Cloud Console 中打开“转移”页面。
打开转移页面
点击创建转移作业。
按照分步演示操作，在完成每个步骤后点击继续：
- 选择来源：使用 Google Cloud Storage 存储分区作为您选择的来源，然后点击浏览以查找并选择要移出对象的存储分区。
- 选择目的地：点击浏览以查找并选择要移入对象的存储分区。
  
  此外，请选中在转移完成后删除来源对象复选框。
- 配置转移：您可以忽略此部分。
完成分步演示后，点击创建。

然后系统会开始将旧存储分区中的对象复制到新存储分区中。此过程可能需要一些时间；但是，点击创建后，您可以离开 Google Cloud Console。

如需查看转移进度，请在 Google Cloud Console 中打开“转移”页面。

打开转移页面

请参阅问题排查，了解如何获取有关 Cloud Storage 浏览器中失败操作的详细错误信息。

gsutil

确保至少安装了 gsutil 4.12。
使用带有 -r 选项的 gsutil cp 命令，以递归方式将所有对象从源存储分区复制到目标存储分区中。
```
gsutil cp -r gs://[SOURCE_BUCKET]/* gs://[DESTINATION_BUCKET]
```
其中：
- [SOURCE_BUCKET] 是原始存储分区的名称，例如 old-bucket。
- [DESTINATION_BUCKET] 是您在“第 1 步：创建新存储分区”中创建的新存储分区的名称，例如 my-bucket。

REST API

JSON API

使用 JSON API 的 rewrite 方法，将数据细分成多个大小有限的数据块，然后通过多个请求复制这些数据块。执行此操作时，您必须循环操作并调用 rewrite 方法，直到所有数据都移动完为止：

使用 cURL 和 JSON API rewrite 方法将数据从源存储分区复制到目标存储分区中：
```
curl -X POST \
-H "Authorization: Bearer [OAUTH2_TOKEN]" \
-H "Content-Length: 0" \
"https://storage.googleapis.com/storage/v1/b/[SOURCE_BUCKET]/o/[OBJECT_NAME]/rewriteTo/b/[DESTINATION_BUCKET]/o/[OBJECT_NAME]"
```
其中：
- [OAUTH2_TOKEN] 是您在“第 1 步：创建新存储分区”中生成的访问令牌。
- [SOURCE_BUCKET] 是原始存储分区的名称，例如 old-bucket。
- [OBJECT_NAME] 是您要复制的对象的名称，例如 pets/dog.png。
- [DESTINATION_BUCKET] 是您在“第 1 步：创建新存储分区”中创建的新存储分区的名称，例如 my-bucket。
例如，如果对象的大小为 10 GB，则此请求的响应与以下示例类似：
```
{
"kind": "storage#rewriteResponse",
"totalBytesRewritten": 1048576,
"objectSize": 10000000000,
"done": false,
"rewriteToken": [TOKEN_VALUE]
}
```
在后续请求中使用 rewriteToken 继续复制数据：
```
curl -X POST \
-H "Authorization: Bearer [OAUTH2_TOKEN]" \
-H "Content-Length: 0" \
-d '{"rewriteToken": "[TOKEN_VALUE]"}' \
"https://storage.googleapis.com/storage/v1/b/[SOURCE_BUCKET]/o/[OBJECT_NAME]/rewriteTo/b/[DESTINATION_BUCKET]/o/[OBJECT_NAME]"
```
其中：
- [OAUTH2_TOKEN] 是您在“第 1 步：创建新存储分区”中生成的访问令牌。
- [TOKEN_VALUE] 是第 1 步中返回的 rewriteToken 值。
- [SOURCE_BUCKET] 是原始存储分区的名称，例如 old-bucket。
- [OBJECT_NAME] 是您要复制的对象的名称，例如 pets/bunny.png。
- [DESTINATION_BUCKET] 是您在“第 1 步：创建新存储分区”中创建的新存储分区的名称，例如 my-bucket。

复制完所有数据后，最后一个响应将包含一个 done 属性（等于 true），没有 rewriteToken 属性，数据复制到的对象的元数据包含在 resource 属性中。

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

第 3 步：删除旧存储分区中的对象

控制台

您无需执行任何操作来删除旧存储分区中的对象：在使用 Transfer Service 复制对象的过程中，旧对象会被自动删除（假设您选中了“在转移完成后删除来源对象”复选框）。

gsutil

使用带有 -r 选项的 gsutil rm 命令，以递归方式从源存储分区删除您的所有对象，并删除源存储分区本身：

gsutil rm -r gs://[SOURCE_BUCKET]

其中 [SOURCE_BUCKET] 是原始存储分区的名称，例如 old-bucket。

或者，如需删除对象但保留源存储分区，请运行以下命令：

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

REST API

JSON API

使用 cURL 和 JSON API delete 方法，通过以下命令移除您的数据的原始版本：
```
curl -X DELETE \
-H "Authorization: Bearer [OAUTH2_TOKEN]" \
"https://storage.googleapis.com/storage/v1/b/[SOURCE_BUCKET]/o/[OBJECT_NAME]"
```
其中：
- [OAUTH2_TOKEN] 是您在“第 1 步：创建新存储分区”中生成的访问令牌。
- [SOURCE_BUCKET] 是原始存储分区的名称，例如 old-bucket。
- [OBJECT_NAME] 是您要删除的对象的名称，例如 pets/dog.png。

如果成功，该方法将返回一个空响应。

移动和重命名存储分区

第 1 步：创建新存储分区

控制台

gsutil

代码示例

C++

C#

Go

Java

Node.js

PHP

Python

Ruby

REST API

JSON API

XML API

第 2 步：将旧存储分区中的对象复制到新存储分区中

控制台

gsutil

REST API

JSON API

第 3 步：删除旧存储分区中的对象

控制台

gsutil

REST API

JSON API

后续步骤