文档中心

对象存储

文件解压缩

CreateFileUncompress

CreateFileUncompress

功能描述

此接口用于提交文件解压任务解压文件，解压完成后，异步返回压缩包内文件。

注意事项

限制类型	限制说明
邀测限制	此接口当前处于邀测状态，如需使用，请联系客户经理开通白名单。
权限说明	使用子账号操作时，请先通过主账号或拥有访问控制管理权限的子账号在访问控制 > 权限策略中创建或编辑自定义策略，为当前桶添加 tos:CreateFileProcessJobs 权限，再将该策略绑定至需要使用本功能的子账号。
解压方式	流式解压，会边解压边输出解压文件。如果解压过程中有部分文件损坏导致解压操作中止，会保留已解压的部分文件。
大小限制	压缩包需小于 40 GB，单个文件解压后需小于 40GB。
加密限制	不支持解压加密的压缩包。
类型限制	仅支持标准存储类型的文件
文件数量限制	zstd 场景下数量限制为 1 个。

请求消息样式

请求参数和消息头

名称	位置	参数类型	是否必选	示例值	说明
file_jobs	Query	String	是	-	代表 FileUncompress 请求的特殊标识。
job_type	Query	String	是	FileUncompress	任务类型，取值 FileUncompress，表示文件解压任务。

请求元素

名称	参数类型	是否必选	示例值	说明
Input	Array	是	-	待解压的压缩包信息。
Object	String	是	input/test.zip	压缩包的名称。父节点：Input
FileUncompressConfig	Array	是	-	解压规则。
Prefix	String	是	output/	指定解压后输出文件的前缀，不填则默认保存在存储桶根路径。父节点：FileUncompressConfig
PrefixReplaced	Integer	否	1	解压后的文件路径前缀替换方式。默认值为 0，仅文件类型为 zip 时生效。取值如下： 0：不添加额外前缀，解压文件保存至 Prefix 指定的路径下（不保留压缩包名称）。 1：以压缩包名称作为前缀，解压文件保存至 Prefix 指定的路径下。 2：以压缩包完整路径作为前缀；若未指定 Prefix，则解压至压缩包所在路径（包含压缩包名称）。父节点：FileUncompressConfig
Output	Array	是	-	设置存储桶，用于存放解压后的文件。
Region	String	是	cn-beijing	存储桶的地域，不支持跨地域存储。父节点：Output
Bucket	String	是	testbkt	保存解压后文件的存储桶名称。父节点：Output

响应消息头

该请求返回公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
Code	String	OK	状态码。请求成功时返回值为 OK 。请求失败时返回值为对应的错误码。
JobId	String	8c6c1aa3a3d5948b27f000181fb********	任务 ID。文件解压任务提交后，您可以在 Bucket 参数指定的存储桶中查看解压后的文件。

请求示例

响应示例

最近更新时间：2026.09.17 17:58:11

这个页面对您有帮助吗？

有用

有用

无用

无用