本页面介绍如何更改存储分区的默认存储类别。将对象上传到存储分区时,如果您没有指定对象的存储类别,则系统会为该对象分配存储分区的默认存储类别。如需查看存储分区的概览,请参阅关键术语。如需详细了解存储类别,请参阅存储类别。
前提条件
前提条件因所使用的工具而异:
控制台
如需使用 Google Cloud Console 完成本指南,您必须拥有适当的 IAM 权限。如果您没有创建要访问的存储桶,则可能需要项目所有者为您提供包含必要权限的角色。
如需查看特定操作所需权限的列表,请参阅 Google Cloud Console 的 IAM 权限。
如需查看相关角色的列表,请参阅 Cloud Storage 角色。或者,您也可以创建一个自定义角色,并为其提供具体受限的权限。
命令行
为使用命令行实用程序完成本指南,您必须拥有适当的 IAM 权限。如果您没有创建要访问的存储桶,则可能需要项目所有者为您提供包含必要权限的角色。
如需查看特定操作所需权限的列表,请参阅 gsutil 命令的 IAM 权限。
如需查看相关角色的列表,请参阅 Cloud Storage 角色。或者,您也可以创建一个自定义角色,并为其提供具体受限的权限。
代码示例
如需使用 Cloud Storage 客户端库完成本指南,您必须拥有适当的 IAM 权限。如果您没有创建要访问的存储桶,则可能需要项目所有者为您提供包含必要权限的角色。除非另有说明,否则客户端库请求通过 JSON API 发出。
如需查看特定操作所需的权限列表,请参阅 JSON 方法的 IAM 权限。
如需查看相关角色的列表,请参阅 Cloud Storage 角色。或者,您也可以创建一个自定义角色,并为其提供具体受限的权限。
REST API
JSON API
如需使用 JSON API 完成本指南,您必须拥有适当的 IAM 权限。如果您没有创建要访问的存储桶,则可能需要项目所有者为您提供包含必要权限的角色。
如需查看特定操作所需的权限列表,请参阅 JSON 方法的 IAM 权限。
如需查看相关角色的列表,请参阅 Cloud Storage 角色。或者,您也可以创建一个自定义角色,并为其提供具体受限的权限。
更改存储桶的默认存储类别
控制台
- 在 Google Cloud Console 中,转到 Cloud Storage 的浏览器页面。
在存储分区列表中,找到要修改的存储分区,然后点击其存储分区溢出 (Bucket overflow) 菜单 (
)。
点击修改默认存储类别。
在重叠式窗口中,为您的存储分区选择所需的新默认存储类别。
点击保存。
如需了解如何获取有关 Cloud Storage 浏览器中失败操作的详细错误信息,请参阅问题排查。
命令行
使用 gsutil defstorageclass set
命令:
gsutil defstorageclass set STORAGE_CLASS gs://BUCKET_NAME
其中:
STORAGE_CLASS
是您想要用于存储分区的新存储类别,例如nearline
。BUCKET_NAME
是相关存储分区的名称, 例如my-bucket
。
响应类似如下示例:
Setting default storage class to "nearline" for bucket gs://my-bucket
代码示例
C++
如需了解详情,请参阅 Cloud Storage C++ API 参考文档。
C#
如需了解详情,请参阅 Cloud Storage C# API 参考文档。
Go
如需了解详情,请参阅 Cloud Storage Go API 参考文档。
Java
如需了解详情,请参阅 Cloud Storage Java API 参考文档。
Node.js
如需了解详情,请参阅 Cloud Storage Node.js API 参考文档。
PHP
如需了解详情,请参阅 Cloud Storage PHP API 参考文档。
Python
如需了解详情,请参阅 Cloud Storage Python API 参考文档。
Ruby
如需了解详情,请参阅 Cloud Storage Ruby API 参考文档。
REST API
JSON API
- 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。 如需了解相关说明,请参阅 API 身份验证。
创建一个包含以下信息的 JSON 文件:
{ "storageClass": "STORAGE_CLASS" }
其中
STORAGE_CLASS
是您想要用于存储桶的新存储类别,例如nearline
。使用
cURL
,通过PATCH
Bucket 请求调用 JSON API:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=storageClass"
其中:
JSON_FILE_NAME
是您在第 2 步中创建的 JSON 文件的路径。OAUTH2_TOKEN
是您在第 1 步中生成的访问令牌。BUCKET_NAME
是相关存储分区的名称,例如my-bucket
。
XML API
- 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。 如需了解相关说明,请参阅 API 身份验证。
创建一个包含以下信息的 XML 文件:
<StorageClass>STORAGE_CLASS</StorageClass>
其中
STORAGE_CLASS
是您想要用于存储桶的新存储类别的名称,例如nearline
。使用
cURL
,通过PUT
Bucket 请求调用 XML API:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?storageClass"
其中:
XML_FILE_NAME
是您在第 2 步中创建的 XML 文件的路径。OAUTH2_TOKEN
是您在第 1 步中生成的访问令牌。BUCKET_NAME
是相关存储分区的名称,例如my-bucket
。