更改对象存储类别

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

Console

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

gsutil

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

gsutil rewrite -s [STORAGE_CLASS] gs://[PATH_TO_OBJECT]

其中，[STORAGE_CLASS] 是对象的新存储类别，[PATH_TO_OBJECT] 是要更改类别的对象的名称。

REST API

JSON API

注意：要从原始对象中保留的 ACL 必须包含在请求正文中提供的对象资源中。

1. 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。
2. 创建一个包含以下信息的 .json 文件，并将 [VALUES_IN_BRACKETS] 替换为适当的值：

{
"storageClass": "[STORAGE_CLASS]"
}

3. 使用 cURL 调用 JSON API，并将 [VALUES_IN_BRACKETS] 替换为适当的值：

   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/[BUCKET_NAME]/o/[OBJECT_NAME]/rewriteTo/b/[BUCKET_NAME]/o/[OBJECT_NAME]"

XML API

注意：您希望从原始对象中保留的元数据（例如自定义元数据）必须包含在您在请求中提供的标头中。此外，在上传对象后，如果对象的 ACL 与包含对象的存储分区的默认对象 ACL 不同，则您必须重新应用对象的 ACL。

1. 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。
2. 在请求中添加应更改存储类别的对象（在使用 XML API 更改存储类别时，您必须重新上传该对象）。
3. 使用 cURL 调用 XML API，并将 [VALUES_IN_BRACKETS] 替换为适当的值：

   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]"

如需了解更多信息，请参阅设置对象存储类别页面。

注意：本指南涉及数据覆盖操作。如果数据最初存储在 Nearline 或 Coldline 类别中，则可能会产生检索费用和提前删除费用。另请注意，如果您为存储分区启用了对象版本控制，则原始对象将保留在存储分区中，直到它被明确删除为止。