文件解压缩_API_Object Storage-文档中心

此接口提供解压对象存储平台上压缩包的功能。解压后，会在对象存储上默认生成一个列表文件，文件内容包含解压出的文件信息。

请求描述

请求格式

POST /fops
Host: <MgrDomain>
Authorization: <accessToken>

管理凭证参数

<path>:/fops
<body>:<RequestParams>, (即请求内容)

Header 参数描述

参数	是否必需	描述
Host	是	管理域名，可在控制台的空间概览界面获取
Authorization	是	管理凭证

请求体格式

请求参数以如下格式组织并作为请求内容提交：

bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&fops=<Urlsafe_Base64_Encoded_Fops>&notifyURL=<Urlsafe_Base64_Encoded_PersistentNotifyUrl>&force=<Force>&separate=<Separate>

请求体参数描述

参数	是否必需	描述
bucket	是	存储空间名。
key	是	文件名，指定要解压的压缩文件。
fops	是	处理参数列表。参数含义请参见解压Ops参数格式。支持同时发起多个处理请求，以 ; 分隔参数列表。
notifyURL	否	处理结果接收通知的URL，请参考通知数据内容描述。
force	否	是否强制数据处理。服务器发现fops指定的数据处理结果已存在，认为已处理成功，以避免重复处理浪费资源。添加此字段并设为1以强制数据处理并覆盖原结果。默认为0。
separate	否	是否为转码分开通知选项。设1和0为选项码： 1表示每执行一个转码指令就通知notifyURL 0表示所有转码描述执行完后一次性通知notifyURL。默认为0。

响应描述

如果请求成功，将返回包含以下内容的JSON字符串：

{ "persistentId": <persistentId> }

字段名称	是否必需	描述
persistentId	是	上传预处理或触发持久化处理的处理ID

如果请求失败，将返回包含以下内容的JSON字符串：

{
    "code":     "<code string>",
    "message":  "<ErrMsg string>"
}

字段名称	是否必需	描述
code	是	HTTP请求响应代码，请参见HTTP响应状态码
message	是	当文件解压处理失败时的提示信息

清单文件说明

解压成功后，将在对应的空间目录生成一个列表文件，该文件名默认形式为：随机数+时间戳+压缩包名.list。

文件内容格式如下：

url \t  key \t  status

参数描述

参数	类型	描述
url	string	文件的具体访问路径。
entryURI	string	entryURI是标识资源在对象存储端位置的信息，由空间名和文件名拼接而成。拼接串为 “:” 示例：video:1.txt，空间名为video，文件名为1.txt。
status	int	状态码，0表示新文件，1表示覆盖原文件，2表示保留文件，3表示解压异常，-1表示解压文件保存失败。

示例

curl -v -X POST -d "bucket=aW1hZ2Vz&key=dGVzdC56aXA&fops = ZGVjb21wcmVzc2lvbi96aXA=&force=1&separate=0" -H "Authorization: 86622e227a50d49d858c2494a935bc2e4ac543a7: NmNlYmI5YzczMjlkN2MxYTYxNWYyMjE4MDMxZTVjMWQ3ZjlkZTVmOA ==" --url "http://mgrDomain/fops"

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

文件解压缩

请求描述

响应描述

清单文件说明

示例

目录