文档首页/ 对象存储服务 OBS/ API参考/ 桶API/ 在线解压/ 获取在线解压策略-GetDecompressPolicy
更新时间：2026-07-08 GMT+08:00
查看PDF
分享

获取在线解压策略-GetDecompressPolicy

功能介绍

可通过本接口查询指定桶的文件解压策略。如果策略存在，则返回成功，status code返回值为200。了解更多在线解压相关信息，请参见在线解压。

URI 参数 obscompresspolicy 是 OBS 侧定义的子资源名称，是对"压缩/解压缩"功能的统称；接口名使用 DecompressPolicy 是对该策略实际业务语义（解压缩）的精确表达。

URI

GET /

调用方法

请参见如何调用API。调用前需要先计算API签名，并将签名添加到请求中。

您还可以使用API Explorer在线调试接口。

请求消息样式

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。

请求体参数（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。

响应体 (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。

错误响应消息

无特殊错误，所有错误已包含在错误码概述和OEF错误码中。

请求示例

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"
	}]
}

相关文档

  • 了解更多在线解压相关信息，请参见在线解压 。
  • API操作涉及的计费项参见计费项。
父主题： 在线解压

相关文档