设置桶归档对象直读策略
功能介绍
归档对象直读是指用户可以不用恢复归档对象,便能直接对其进行操作。
默认情况下,桶没有开启归档对象直读功能。
本接口主要用来开启或关闭桶的归档对象直读功能。
- 设置桶的归档对象直读状态为Enabled,开启桶的归档对象直读功能:
- 桶内存在归档对象时,不管该归档对象是否已经恢复,均可以直接操作该归档对象。
- 如果归档对象没有恢复,操作该归档对象时会增加单独计费。
- 设置桶的归档对象直读状态为Disabled,关闭桶的归档对象直读功能:
- 归档对象无法直接操作,需要先恢复。
要正确执行此操作,需要确保执行者有PutDirectColdAccessConfiguration权限。默认情况下只有桶的所有者可以执行此操作,也可以通过设置桶策略或用户策略授权给其他用户。
当前归档数据直读功能支持的区域请参见功能总览。
请求消息样式
1 2 3 4 5 6 7 8 9 10 |
PUT /?directcoldaccess HTTP/1.1 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Date: date Authorization: authorization Content-MD5: MD5 Content-Length: length <DirectColdAccessConfiguration> <Status>status</Status> </DirectColdAccessConfiguration> |
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用的消息头如表1所示。
请求消息元素
在此请求中,需要在请求的消息体中配置桶的归档对象直读状态,配置信息以XML格式上传。具体的配置元素如表2所示。
响应消息样式
1 2 3 4 |
HTTP/1.1 status_code Date: date Content-Length: length |
响应消息头
该请求的响应消息使用公共消息头,具体请参考表1。
响应消息元素
该请求的响应消息中不带消息元素。
错误响应消息
无特殊错误,所有错误已经包含在表2中。
请求示例
1 2 3 4 5 6 7 8 9 10 11 |
PUT /?directcoldaccess HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Date: Fri, 26 Apr 2019 07:37:36 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo= Content-MD5: h4A//0EKGFKAwJkH231A== Content-Length: 92 <DirectColdAccessConfiguration> <Status>Enabled</Status> </DirectColdAccessConfiguration> |
响应示例
1 2 3 4 5 6 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: 0000016A58940244809DEF00122E6802 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCStOlo1yxthHHo2GlS3WGgt1ekAIh3Vy Date: Fri, 26 Apr 2019 07:37:36 GMT Content-Length: 0 |