设置在线解压策略
功能介绍
本接口用于为指定桶配置ZIP文件解压策略。接口是幂等的,如果桶上已存在相同策略内容,则返回成功,status code返回值为200;否则status code返回值为201。
请求消息样式
PUT /?obscompresspolicy HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Authorization: authorization Content-Type: application/json Content-Length: length Date: date policy json body
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用公共消息头,具体参见表3。
请求消息元素
名称 |
描述 |
是否必选 |
---|---|---|
rules |
策略规则数组。 类型:Container 取值范围:数组大小[1, 10]
说明:
同一个桶下的不同策略前缀不能重复和起始包含,委托建议使用同一个。 |
是 |
名称 |
描述 |
是否必选 |
---|---|---|
id |
解压策略名称。当前桶上配置的解压规则的唯一标识。 类型:String 取值范围:[1, 256],满足“^[a-zA-Z0-9_-]{1, 256}$”,既长度为1~256个字符。只能由大写或小写的英文字母、数字、下划线(_)和连字符(-)组成。例如:event_0001。 |
是 |
project |
项目ID。 类型:String |
是 |
agency |
委托名。客户通过委托赋予OBS服务查询用户桶内指定对象是否存在以及向用户桶内上传对象的权限。 类型:String |
是 |
events |
触发事件类型。 类型:String 支持: ["ObjectCreated:*"] ["ObjectCreated:Put"] ["ObjectCreated:Post"] ["ObjectCreated:Copy"] ["ObjectCreated:CompleteMultipartUpload"] |
是 |
prefix |
匹配规则前缀。 类型:String 取值范围:[0, 1023] |
否 |
suffix |
匹配规则后缀。 类型:String 固定值:.zip |
是 |
overwrite |
解压后同名文件的处理方式。 类型:Integer 取值范围:0:不覆盖跳过,1:不覆盖,以文件的CRC32值重命名,2:覆盖。 |
是 |
decompresspath |
文件解压后存放的路径,不为空时必须以“/”结尾。 类型:String 取值范围:[0, 800] |
否 |
policytype |
文件解压策略类型。 类型:String 固定值:decompress |
是 |
请保证解压策略名称、解压路径、IAM委托名称长度之和不超过800。
响应消息样式
HTTP/1.1 status Server: OBS Date: date Content-Length: length
响应消息头
该请求的响应消息使用公共消息头,具体请参考表1。
响应消息元素
该请求的响应消息中不带消息元素。
请求示例
PUT /?obscompresspolicy HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo= Content-Type: application/json Content-Length: 497 Date: Tue, 21 Jul 2020 15:38:30 GMT { "rules": [{ "id": "ruleid", "project": "your project id", "agency": "testagency", "events": ["ObjectCreated:*"], "prefix": "decompress", "suffix": ".zip", "overwrite": 0, "decompresspath": "after-decompress/", "policytype": "decompress" }] }
响应示例
HTTP/1.1 201 Created Server: OBS Date: Tue, 07 Jul 2020 07:29:13 GMT Content-Length: 0