更新时间:2025-08-13 GMT+08:00
分享

获取DIS通知策略

功能介绍

本接口用于查询指定桶的DIS通知策略信息。如果策略存在,则返回成功,status code返回值为200。

请求消息样式

GET /?disPolicy HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Authorization: authorization
Date: date

请求消息参数

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

请求消息头

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

请求消息元素

该请求消息中不使用消息元素。

响应消息样式

HTTP/1.1 status_code
Server: OBS
Date: date
Content-Type: type
Content-Length: length

policy json body

响应消息头

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

响应消息元素

表1 响应消息元素

参数名称

参数类型

描述

id

String

参数解释:

规则ID。当前桶上配置的DIS策略规则的唯一标识。

取值范围:

长度为1~256的字符串,并且字符只能是大写字母、小写字母、数字、下划线(_)或连字符(-)。

stream

String

参数解释:

DIS服务通道名称。

取值范围:

不涉及

project

String

参数解释:

DIS服务通道所属的项目ID。

取值范围:

获取项目ID的操作请参见获取账号、IAM用户、项目、用户组、区域、委托的名称和ID

events

Array

参数解释:

OBS事件列表。

取值范围:

长度为0~1023的字符串,取值允许为任意字符。支持的事件类型请参见使用DIS发送OBS事件通知

prefix

String

参数解释:

对象名前缀。

取值范围:

长度为0~1024的字符串。

suffix

String

数解释:

对象名后缀。

取值范围:

长度为0~1024的字符串。

agency

String

参数解释:

IAM委托名。

取值范围:

不涉及

错误响应消息

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

请求示例

GET /?disPolicy HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo=
Date: Tue, 21 Jul 2020 22:28:46 GMT

响应示例

HTTP/1.1 200 OK
Server: OBS
Date: Tue, 07 Jul 2020 07:28:46 GMT
Content-Type: application/json
Content-Length: 1063
{
    "rules": [{
        "id": "event-01",
        "stream": "stream_name",
        "project": "project_id",
        "events": ["ObjectCreated:*", "ObjectRemoved:*"],
        "prefix": "",
        "suffix": "",
        "agency": "agency001"
    }]
}

相关文档