更改对象存储类别

本页面介绍了如何通过覆盖对象来更改存储分区中对象的存储类别。如需了解如何在不覆盖对象的情况下更改对象存储类别，请参阅对象生命周期管理功能。

控制台

不能通过 Console 设置各个对象存储类别。请改为使用 gsutil。

gsutil

在 rewrite 命令中使用 -s 标志，例如：

gsutil rewrite -s STORAGE_CLASS gs://PATH_TO_OBJECT

其中：

  • STORAGE_CLASS 是对象的新存储类别，例如 nearline。
  • PATH_TO_OBJECT 是您想要更改其类别的对象的名称，例如 pets/dog.png。

代码示例

C++

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

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name,
   std::string const& object_name, std::string const& storage_class) {
  StatusOr<gcs::ObjectMetadata> object_metadata =
      client.RewriteObjectBlocking(
          bucket_name, object_name, bucket_name, object_name,
          gcs::WithObjectMetadata(
              gcs::ObjectMetadata().set_storage_class(storage_class)));

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

  std::cout << "Changed storage class of object " << object_metadata->name()
            << " in bucket " << object_metadata->bucket() << " to "
            << object_metadata->storage_class() << "\n";
}

Java

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

import com.google.cloud.storage.Blob;
import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.BlobInfo;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageClass;
import com.google.cloud.storage.StorageOptions;

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

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

    // The ID of your GCS object
    // String objectName = "your-object-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    BlobId blobId = BlobId.of(bucketName, objectName);

    // 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;

    // You can't change an object's storage class directly, the only way is to rewrite the object
    // with the
    // desired storage class
    Storage.CopyRequest request =
        Storage.CopyRequest.newBuilder()
            .setSource(blobId)
            .setTarget(BlobInfo.newBuilder(blobId).setStorageClass(storageClass).build())
            .build();
    Blob updatedBlob = storage.copy(request).getResult();

    System.out.println(
        "Object "
            + objectName
            + " in bucket "
            + bucketName
            + " had its storage class set to "
            + updatedBlob.getStorageClass().name());
  }
}

REST API

JSON API

  1. 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。

  2. 创建一个包含以下信息的 .json 文件：

    {
  "storageClass": "STORAGE_CLASS"
}

    其中：

    • STORAGE_CLASS 是对象的新存储类别，例如 nearline。

  3. 使用 cURL，通过 POST Object 请求调用 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/BUCKET_NAME/o/OBJECT_NAME/rewriteTo/b/BUCKET_NAME/o/OBJECT_NAME"

    其中：

    • JSON_FILE_NAME 是您在第 2 步中创建的 JSON 文件的名称。
    • OAUTH2_TOKEN 是您在第 1 步中生成的访问令牌。
    • BUCKET_NAME 是包含原始对象的存储分区的名称。例如 my-bucket。
    • OBJECT_NAME 是对象的名称， 例如 pets/dog.png。

XML API

  1. 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。

  2. 使用 cURL，通过 PUT Object 请求调用 XML API：

    curl -X PUT --data-binary @OBJECT \
  -H "Authorization: Bearer OAUTH2_TOKEN" \
  -H "Content-Type: OBJECT_CONTENT_TYPE" \
  -H "x-goog-storage-class: STORAGE_CLASS" \
  "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"

    其中：

    • OBJECT 是您想要更改其存储类别的对象的本地路径（使用 XML API 更改存储类别时，您必须重新上传对象），例如 Desktop/dog.png。
    • OAUTH2_TOKEN 是您在第 1 步中生成的访问令牌。
    • OBJECT_CONTENT_TYPE 是该对象的内容类型，例如 image/png。
    • STORAGE_CLASS 是对象的新存储类别，例如 nearline。
    • BUCKET_NAME 是包含要覆盖的对象的存储分区名称，例如 my-bucket。
    • OBJECT_NAME 是要覆盖的对象的名称，例如 pets/dog.png。

后续步骤