设置DIS通知策略
功能介绍
本接口用于为指定桶配置DIS通知策略。接口是幂等的，若桶上已存在相同策略内容，则返回成功，status code返回值为200；否则status code返回值为201。
请求消息样式
PUT /?disPolicy HTTP/1.1
Host: bucketname.obs.region.example.com
Authorization: authorization
Content-Type: application/json
Content-Length: length
Date: date
Body:
{
"rules": [{
"id":"rule_id",
"stream": "stream_name",
"project": "project_id",
"events": ["ObjectCreated:*", "ObjectRemoved:*"],
"prefix": "",
"suffix": "",
"agency": "agency_name"
}]
}
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用公共消息头，具体参见表3。
请求消息元素
|
名称 |
描述 |
是否必选 |
|---|---|---|
|
rules |
策略规则数组。 类型：Container 取值范围：[1, 10]
说明：
同一个桶下的不同策略前缀不能重复和起始包含，委托建议使用同一个。 |
是 |
|
名称 |
描述 |
是否必选 |
|---|---|---|
|
id |
规则ID。当前桶上配置的DIS策略规则的唯一标识。 类型：String 取值范围：[1, 256]，满足“^[a-zA-Z0-9_-]{1, 256}$” |
是 |
|
stream |
DIS服务通道名称。需要先在DIS服务创建此通道。 类型：String |
是 |
|
project |
DIS服务通道所属的项目ID。 类型：String |
是 |
|
events |
OBS事件列表。 类型：String 有效值：长度[0, 1023]，值允许为任意字符，支持如下事件类型：
|
是 |
|
prefix |
对象名前缀，用于指定的对象名关键字，根据定义的前缀，输入需要过滤的对象的关键字信息，字符越长匹配精度越高，最大可支持1024个字符，最小可为空。同时，prefix和suffix加起来长度最大为1024个字符。 类型：String 取值范围：[0, 1024] |
否 |
|
suffix |
对象名后缀。用于指定的对象名关键字，根据定义的后缀，输入需要过滤的对象的关键字信息，字符越长匹配精度越高，最大可支持1024个字符，最小可为空。同时，prefix和suffix加起来长度最大为1024个字符。 类型：String 取值范围：[0, 1024] |
否 |
|
agency |
IAM委托名，被委托方必须包含OBS服务，赋予的权限必须是DIS服务的DIS Administrator或DIS User。 类型：String |
是 |
响应消息样式
HTTP/1.1 status Server: OBS Date: date Content-Length: length
响应消息头
该请求的响应消息使用公共消息头，具体请参考表1。
响应消息元素
该请求的响应消息中不带消息元素。
错误响应消息
无特殊错误，所有错误已经包含在表2中。
请求示例
PUT /?disPolicy HTTP/1.1
Host: bucketname.obs.region.example.com
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo=
Content-Type: application/json
Content-Length: 1049
Date: Tue, 21 Jul 2020 15:38:30 GMT
{
"rules": [{
"id":"event-01",
"stream": "stream_name",
"project": "project_id",
"events": ["ObjectCreated:*", "ObjectRemoved:*"],
"prefix": "",
"suffix": "",
"agency": "dis_agency"
}]
}
响应示例
HTTP/1.1 201 Created Server: OBS Date: Tue, 07 Jul 2020 07:29:13 GMT Content-Length: 0
