更新时间:2024-05-17 GMT+08:00

设置在线解压策略

功能介绍

本接口用于为指定桶配置ZIP文件解压策略。接口是幂等的,如果桶上已存在相同策略内容,则返回成功,status code返回值为200;否则status code返回值为201。

请求消息样式

PUT /?obscompresspolicy HTTP/1.1
Host: bucketname.obs.region.myhuaweicloud.com 
Authorization: authorization
Content-Type: application/json
Content-Length: length
Date: date

policy json body

请求消息参数

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

请求消息头

该请求使用公共消息头,具体参见表3

请求消息元素

表1 请求消息元素

名称

描述

是否必选

rules

策略规则数组。

类型:Container

取值范围:数组大小[1, 10]

说明:

同一个桶下的不同策略前缀不能重复和起始包含,委托建议使用同一个。

表2 rules参数说明

名称

描述

是否必选

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

响应消息元素

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

错误响应消息

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

请求示例

PUT /?obscompresspolicy HTTP/1.1
Host: bucketname.obs.region.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