PutBucketStorageClass--对象存储-火山引擎

文档中心

导航

对象存储

PutBucketStorageClass

最近更新时间：2024.08.01 20:30:30首次发布时间：2023.03.14 21:02:15

功能描述

PutBucketStorageClass 接口用于为存储桶（Bucket）设置默认存储类型。设置了桶默认存储策略后，若上传对象、拷贝对象和初始化分片上传任务时未指定对象的存储类型，则该对象的存储类型为桶的存储类型。桶的默认存储类型为 STANDARD（标准存储类型）。

注意事项

调用此接口您必须为桶所有者，或被授权当前桶的 PutBucketStoragePolicy 权限。使用桶策略实现权限控制的详细说明，请参见存储桶授权策略管理。
关于 TOS 不同存储类型的适用场景及区别，请参见存储类型。

请求消息样式

PUT /?storageClass HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string
x-tos-storage-class: STANDARD

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
storageClass	Query	String	是	-	代表 PutBucketStorageClass 请求的特殊标识。
x-tos-storage-class	Header	String	是	STANDARD	桶的默认存储类型，取值说明如下： `STANDARD`：标准存储。 `IA`：低频访问存储。 `ARCHIVE_FR`：归档闪回存储。 `ARCHIVE`：归档存储。 `COLD_ARCHIVE`：冷归档存储。 `DEEP_COLD_ARCHIVE`：深度冷归档存储。说明深度冷归档目前处于邀测状态，如您需要使用该存储类型，请联系客户经理。

名称

位置

参数类型

是否必选

示例值

说明

storageClass

Query

String

是

代表 PutBucketStorageClass 请求的特殊标识。

x-tos-storage-class

Header

String

是

STANDARD

桶的默认存储类型，取值说明如下：

STANDARD：标准存储。
IA：低频访问存储。
ARCHIVE_FR：归档闪回存储。
ARCHIVE：归档存储。
COLD_ARCHIVE：冷归档存储。
DEEP_COLD_ARCHIVE：深度冷归档存储。
说明
深度冷归档目前处于邀测状态，如您需要使用该存储类型，请联系客户经理。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

PUT /?storageClass HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string
x-tos-storage-class: STANDARD

响应示例

HTTP/1.1 200 OK
x-tos-id-2: f91b0c03a01300c1-a444ed0        
x-tos-request-id: f91b0c03a01300c1-a444ed0            
Date: Fri, 30 Jul 2021 06:45:39 GMT
Content-Length: 0
server: TosServer