Uncompress zip Package
Last update：2025-08-20 11:11:16
This interface provides the function of decompressing compressed packages on the object storage platform. After decompression, a list file is generated by default on the object storage, and the file content contains the decompressed file information.
Request Description
Request Format
POST /fops
Host: <MgrDomain>
Authorization: <accessToken>
Management Credential Parameters
<path>:/fops
<body>:<RequestParams>, (i.e., request content)
Header Parameter Description
| Parameter | Required | Description |
|---|---|---|
| Host | Yes | Management domain name, which can be obtained on the Bucket Overview interface of the Console |
| Authorization | Yes | Management Credential |
Request Body Format
Request parameters are organized in the following format and submitted as request content:
bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&fops=<Urlsafe_Base64_Encoded_Fops>¬ifyURL=<Urlsafe_Base64_Encoded_PersistentNotifyUrl>&force=<Force>&separate=<Separate>
Request Body Parameter Description
| Parameter | Required | Description |
|---|---|---|
| bucket | Yes | Space name. |
| key | Yes | File name, specifying the compressed file to be decompressed. |
| fops | Yes | Process the parameter list. For the meaning of the parameters, please refer to the Decompression Ops Parameter Format. Multiple processing requests are supported at the same time, and the parameter lists are separated by ;. |
| notifyURL | No | URL for receiving notifications of processing results, please refer to the Notification Data Content Description. |
| force | No | Whether to force data processing. When the server finds that the data processing result specified by fops already exists, it considers it has been processed successfully to avoid wasting resources by repeated processing. Add this field and set it to 1 to force data processing and overwrite the original result. The default value is 0. |
| separate | No | Whether to have separate notification options for transcoding. Set 1 and 0 as option codes: 1 means notifyURL is notified after each transcoding instruction is executed 0 means notifyURL is notified once after all transcoding operations are executed. The default value is 0. |
Response Description
- If the request is successful, a
JSONstring with the following content will be returned:
{ "persistentId": <persistentId> }
| Field Name | Required | Description |
|---|---|---|
| persistentId | Yes | The process ID of upload preprocessing or trigger persistence processing |
- If the request fails, a
JSONstring with the following content will be returned:
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| Field Name | Required | Description |
|---|---|---|
| code | Yes | HTTP request response code. Refer to HTTP Response Status Codes |
| message | Yes | Prompt message when file decompression processing fails |
List File Explanation
After successful decompression, a list file is generated in the corresponding space directory. The default file name format is: random number + timestamp + compressed package name.list.
The file content is formatted as follows:
url \t key \t status
Parameter Description
| Parameter | Type | Description |
|---|---|---|
| url | string | The access path of the specific file. |
| key | string | Key is the location information that identifies the resource stored in the object storage end. It is formed by splicing the space name and the file name. The spliced string is “:” Example: video:1.txt, where the space name is video, and the file name is 1.txt. |
| status | int | Status code, 0 means new file, 1 means overwrite original file, 2 means reserved file, 3 means decompression exception, -1 means failed to save the decompressed file. |
Example
curl -v -X POST -d "bucket=aW1hZ2Vz&key=dGVzdC56aXA&fops = ZGVjb21wcmVzc2lvbi96aXA=&force=1&separate=0" -H "Authorization: 86622e227a50d49d858c2494a935bc2e4ac543a7: NmNlYmI5YzczMjlkN2MxYTYxNWYyMjE4MDMxZTVjMWQ3ZjlkZTVmOA ==" --url "http://mgrDomain/fops"
Is the content of this document helpful to you?
Yes
I have suggestion