# 获取DIS通知策略-GetDisPolicy
#### 功能介绍
本接口用于查询指定桶的DIS通知策略信息。如果策略存在，则返回成功，status code返回值为200。了解更多设置DIS通知策略的相关信息，请参见[使用DIS发送OBS事件通知](https://support.huaweicloud.com/usermanual-obs/obs_03_0147.html)。
#### 授权信息
您必须是桶拥有者或者拥有**Tenant Administrator** 权限，才能调用本接口。配置Tenant Administrator权限，需要使用**角色与策略授权** （旧版IAM，即IAM v3接口），授权操作请参考[使用IAM授权](https://support.huaweicloud.com/qs-iam/iam_01_0030.html)。
#### URI
GET /
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-obs/obs_04_0006.html)。调用前需要先[计算API签名](https://support.huaweicloud.com/api-obs/obs_04_0009.html)，并将签名添加到请求中。
您还可以使用[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/OBS/doc?api=GetDisPolicy)在线调试接口。
#### 请求消息样式
```
GET /?disPolicy HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Authorization: authorization
Date: date
```
#### URI参数（URI Parameters）
| 参数        | 类型     | 描述                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| disPolicy | string | **参数解释：** 标识操作DIS策略子资源的查询参数，作为URI参数携带，无参数值。该参数用于区分桶上的不同策略子资源，表示本次请求针对的是DIS事件通知策略。 **取值范围：** 空值（仅需key存在即可，无需赋值，即 ?disPolicy）。 |
   
#### 请求头参数（Request headers）
该请求使用公共请求头，具体参见[表3](https://support.huaweicloud.com/api-obs/obs_04_0007.html#ZH-CN_TOPIC_0136436606__table25197309)。
#### 请求体参数（Request body）
该请求消息中不带请求体参数。
#### 响应消息样式
```
HTTP/1.1 status_code
Server: OBS
Date: date
Content-Type: type
Content-Length: length
{
    "rules": [{
        "id": "event-01",
        "stream": "stream_name",
        "project": "project_id",
        "events": ["ObjectCreated:*", "ObjectRemoved:*"],
        "prefix": "",
        "suffix": "",
        "agency": "agency001"
    }]
}
```
#### 响应头 (Response Headers)
该请求的响应消息使用公共响应头，具体请参考[表1](https://support.huaweicloud.com/api-obs/obs_04_0013.html#ZH-CN_TOPIC_0173612084__d0e686)。
#### 响应体 (Response Body)
表1响应体 
| 参数名称    | 参数类型      | 描述                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| rules   | Container | **参数解释：** 策略规则数组，数组大小的取值范围为\[1, 10\]。rules是id、stream、project、agency、events、prefix、suffix的父节点。                                                                                                                                     |
| id      | String    | **参数解释：** 规则ID。当前桶上配置的DIS策略规则的唯一标识。 **取值范围：** 长度为1\~256的字符串，并且字符只能是大写字母、小写字母、数字、下划线（_）或连字符（-）。                                                 |
| stream  | String    | **参数解释：** DIS服务通道名称。 **取值范围：** 不涉及                                                                                                                  |
| project | String    | **参数解释：** DIS服务通道所属的项目ID。 **取值范围：** 获取项目ID的操作请参见[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 |
| events  | Array     | **参数解释：** OBS事件列表。数组中的元素为字符串类型，长度为0\~1023个字符，取值允许为任意字符。支持的事件类型请参见[使用DIS发送OBS事件通知](https://support.huaweicloud.com/usermanual-obs/obs_03_0147.html)。                                                                             |
| prefix  | String    | **参数解释：** 对象名前缀。 **取值范围：** 长度为0\~1024的字符串。                                                                                                     |
| suffix  | String    | **参数解释：** 对象名后缀。 **取值范围：** 长度为0\~1024的字符串。                                                                                                    |
| agency  | String    | **参数解释：** IAM委托名。 **取值范围：** 不涉及                                                                                                             |
   
#### 错误响应消息
无特殊错误，所有错误已经包含在[错误码概述](https://support.huaweicloud.com/api-obs/obs_04_0115.html)中。
#### 请求示例
```
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"
    }]
}
```
#### 相关文档
- 了解更多设置DIS通知策略的相关信息，请参见[使用DIS发送OBS事件通知](https://support.huaweicloud.com/usermanual-obs/obs_03_0147.html)。
- API操作涉及的计费项参见[计费项](https://support.huaweicloud.com/price-obs/obs_42_0002.html)。