更新时间:2024-09-29 GMT+08:00

设置桶默认存储类型

功能介绍

本接口实现为桶创建或更新桶的默认存储类型配置信息。

要正确执行此操作,需要确保执行者有PutBucketStoragePolicy权限。默认情况下只有桶的所有者可以执行此操作,也可以通过设置桶策略或用户策略授权给其他用户。

设置了桶的默认存储类型之后,如果上传对象、复制对象和初始化多段上传任务时未指定对象的存储类型,则该对象的存储类型取桶的默认存储类型。

未配置桶的默认存储类型时,桶的默认存储类型为STANDARD(标准存储)。

请求消息样式

1
2
3
4
5
6
7
8
9
PUT /?storageClass HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date 
Content-Type: type 
Content-Length: length 
Authorization: authorization 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<StorageClass xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">STANDARD</StorageClass>

请求消息参数

该请求在请求消息中没有带有参数。

请求消息头

该请求没有特殊的请求消息头,公共部分参见表3

请求消息元素

该操作需要附加请求消息元素来指定桶的默认存储类型,具体见表1

表1 附加请求消息元素

元素名称

描述

是否必选

StorageClass

指定桶默认存储类型。

类型:String

取值范围: STANDARD | WARM | COLD | DEEP_ARCHIVE

存储类型有4种:STANDARD(标准存储)、WARM(低频访问存储)、COLD(归档存储)、DEEP_ARCHIVE(深度归档存储)。因此这里可配置的值有:STANDARD、WARM和COLD、DEEP_ARCHIVE(受限公测)

响应消息样式

1
2
HTTP/1.1 status_code
Date: date 

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

响应消息元素

该请求的响应消息中不带消息元素。

错误响应消息

无特殊错误,错误已经包含在表2中。

请求示例

1
2
3
4
5
6
7
8
9
PUT /?storageClass HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 03:18:19 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:Tf6XbndPx/yNgfAVQ6KIXr7tMj4=
Content-Length: 87

<StorageClass xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">STANDARD</StorageClass>

响应示例

1
2
3
4
5
6
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF2600000164368E704B571F328A8797
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSIsw3tPtUn6damTI5acQmQAcEfmTwl3
Date: WED, 01 Jul 2015 03:18:19 GMT
Content-Length: 0