文件解压缩
更新时间：2023-08-17 17:36:12
该接口提供在云存储平台对压缩包进行解压缩的功能。解压缩后在云存储上默认生成一个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>¬ifyURL=<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 entryURI \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”
本篇文档内容对您是否有帮助？
有帮助
我要反馈