九游平台/ 对象存储服务 obs/ api参考/ api/ 桶的高级配置/ 设置桶归档存储对象直读策略
更新时间：2025-01-26 gmt 08:00
查看pdf

设置桶归档存储对象直读策略-九游平台

功能介绍

归档存储对象直读是指用户可以不用恢复归档存储对象，便能直接对其进行操作。

默认情况下，桶没有开启归档存储对象直读功能。

本接口主要用来开启或关闭桶的归档存储对象直读功能。

  • 设置桶的归档存储对象直读状态为enabled，开启桶的归档存储对象直读功能：
    • 桶内存在归档存储对象时，不管该归档存储对象是否已经恢复，均可以直接操作该归档存储对象。
    • 如果归档存储对象没有恢复，操作该归档存储对象时会增加单独计费。
  • 设置桶的归档存储对象直读状态为disabled，关闭桶的归档存储对象直读功能：
    • 归档存储对象无法直接操作，需要先恢复。

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

当前归档数据直读功能支持的区域请参见功能总览。

请求消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
 
put/?directcoldaccesshttp/1.1
host:examplebucket.obs.cn-north-4.myhuaweicloud.com
date:date
authorization:authorization
content-md5:md5
content-length:length

status

请求消息参数

该请求消息中不使用消息参数。

请求消息头

该请求使用的消息头如表1所示。

表1 请求消息头

消息头名称

描述

是否必选

content-md5

按照rfc 1864标准计算出消息体的md5摘要字符串，即消息体128-bit md5值经过base64编码后得到的字符串。也支持设置content-sha256头域，其值为消息体256-bit sha256值经过base64编码后得到的字符串，content-md5和content-sha256二选一。

类型：string

示例：n58ig6hfm7vqi4k0vnwpog==

是

请求消息元素

在此请求中，需要在请求的消息体中配置桶的归档存储对象直读状态，配置信息以xml格式上传。具体的配置元素如表2所示。

表2 桶的归档存储对象直读状态配置元素

名称

描述

是否必选

directcoldaccessconfiguration

归档存储对象直读配置的根节点。

父节点：无

是

status

标识桶的归档存储对象直读状态。

类型：string

父节点：directcoldaccessconfiguration

有效值：enabled，disabled

是

响应消息样式

1
2
3
4
 
http/1.1status_code
date:date
content-length:length

响应消息头

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

响应消息元素

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

错误响应消息

无特殊错误，所有错误已经包含在表2中。

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 
put/?directcoldaccesshttp/1.1
user-agent:curl/7.29.0
host:examplebucket.obs.cn-north-4.myhuaweicloud.com
date:fri,26apr201907:37:36gmt
authorization:obsh4ipjx0tqththebqqcec:sc2pm13wlfcoc/yzlk0mwsi2zpo=
content-md5:h4a//0ekgfkawjkh231a==
content-length:92

enabled

响应示例

1
2
3
4
5
6
 
http/1.1200ok
server:obs
x-obs-request-id:0000016a58940244809def00122e6802
x-obs-id-2:32aaaqaaeaabsaagaaeaabaaaqaaeaabcstolo1yxthhho2gls3wggt1ekaih3vy
date:fri,26apr201907:37:36gmt
content-length:0
父主题： 桶的高级配置

相关文档

网站地图