# 获取在线解压策略-GetDecompressPolicy
#### 功能介绍
可通过本接口查询指定桶的文件解压策略。如果策略存在，则返回成功，status code返回值为200。了解更多在线解压相关信息，请参见[在线解压](https://support.huaweicloud.com/usermanual-obs/obs_03_0368.html)。
URI 参数 obscompresspolicy 是 OBS 侧定义的子资源名称，是对"压缩/解压缩"功能的统称；接口名使用 DecompressPolicy 是对该策略实际业务语义（解压缩）的精确表达。
#### 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=GetBucketObsCompressPolicy)在线调试接口。
#### 请求消息样式
```
GET /?obscompresspolicy HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Authorization: authorization
Date: date
```
#### URI参数（URI Parameters）
| 参数                | 类型     | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| obscompresspolicy | String | **参数解释：** 标识操作在线解压策略子资源的查询参数，作为URI参数携带，无参数值。该参数用于区分桶上的不同策略子资源，表示本次请求针对的是在线解压策略。 **约束限制：** 不涉及。 **取值范围：** 空值（仅需key存在即可，无需赋值，即 ?obscompresspolicy）。 **默认取值：** 不涉及。 |
   
#### 请求头参数（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": "ruleid",
"project": "your project id",
"agency": "testagency",
"events": ["ObjectCreated:*"],
"prefix": "decompress",
"suffix": ".zip",
"overwrite": 0,
"decompresspath": "after-decompress/",
                "policytype": "decompress"
}]
}
```
#### 响应头 (Response Headers)
该请求的响应消息使用公共响应头，具体请参考[表1](https://support.huaweicloud.com/api-obs/obs_04_0013.html#ZH-CN_TOPIC_0173612084__d0e686)。
#### 响应体 (Response Body)
在此请求返回的响应消息体中包含在线解压策略的JSON配置信息
该请求的响应体元素具体含义如[表1]所示。
 表1响应体 
| 参数             | 参数类型            | 描述                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| id             | String          | **参数解释：** 规则唯一标识。 **取值范围：** 1\~256字符，仅允许字母、数字、下划线和连字符。                                                                                                                                                                                                             |
| project        | String          | **参数解释：** 触发服务所属的项目ID。 **取值范围：** 华为云有效的Project ID。                                                                                                                                                                                                                      |
| agency         | String          | **参数解释：** IAM委托名称，用于OBS向触发服务发送消息的授权。 **取值范围：** 符合IAM委托命名规则。                                                                                                                                                                                                           |
| events         | Array of string | **参数解释：** 触发事件类型列表。 **取值范围：** OBS支持的事件类型，如 ObjectCreated:\*。                                                                                                                                                                                                       |
| prefix         | String          | **参数解释：** 对象名前缀过滤条件，仅匹配该前缀的对象触发解压。 **取值范围：** 1\~1024字符。                                                                                                                                                                                                           |
| suffix         | String          | **参数解释：** 对象名后缀过滤条件，仅匹配该后缀的对象触发解压。 **取值范围：** 1\~1024字符。                                                                                                                                                                                                            |
| overwrite      | Int             | **参数解释：** 同名文件覆盖策略。 **取值范围：** - 0（不覆盖）  - 1（覆盖）   |
| decompresspath | String          | **参数解释：** 解压目标路径，解压后文件存放的OBS路径。 **取值范围：** 有效的OBS对象路径。                                                                                                                                                                                                              |
| policytype     | String          | **参数解释：** 策略类型标识。 **取值范围：** 固定值 decompress。                                                                                                                                                                                                                           |
   
#### 错误响应消息
无特殊错误，所有错误已包含在[错误码概述](https://support.huaweicloud.com/api-obs/obs_04_0115.html)和[OEF错误码](https://support.huaweicloud.com/api-obs/obs_04_0115.html#ZH-CN_TOPIC_0000002510799800__table1490164511612)中。
#### 请求示例
```
GET /?obscompresspolicy 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: 497
{
"rules": [{
"id": "ruleid",
"project": "your project id",
"agency": "testagency",
"events": ["ObjectCreated:*"],
"prefix": "decompress",
"suffix": ".zip",
"overwrite": 0,
"decompresspath": "after-decompress/",
                "policytype": "decompress"
}]
}
```
#### 相关文档
- 了解更多在线解压相关信息，请参见[在线解压](https://support.huaweicloud.com/usermanual-obs/obs_03_0368.html) 。
- API操作涉及的计费项参见[计费项](https://support.huaweicloud.com/price-obs/obs_42_0002.html)。