文件解压缩

描述

该接口提供在云存储平台对压缩包进行解压缩的功能。解压缩后在云存储上默认生成一个list文件,文件内容包含解压缩后的文件信息。

请求说明

POST /fops
Host: <MgrDomain>
Authorization: <accessToken>
  • 管理凭证参数
    <path>:/fops
    <body>:<RequestParams>,即请求内容

头部说明

参数 必填 描述
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文件,文件命名默认为:随机数+时间戳+压缩包名.list

文件内容格式如下:
url \t key \t status

参数 类型 描述
url string 具体文件的访问路径
key string Key是标识资源在云存储的位置信息,由空间名和文件名拼接而成,拼接字符串为“:”
范例: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"