全部文档
当前文档
最近更新时间：2025-09-01 19:56:13
概述：客户上传文件压缩包到KS3，通过KS3的在线解压功能，允许客户在不下载整个压缩文件到本地的情况下，可以直接访问KS3内的指定文件。
场景应用：需一次性上传大量的小文件时，可以将所有文件进行压缩，上传之后压缩文件可以自动解压，提高上传效率。
触发机制：当您在KS3上成功创建在线解压策略后，上传到KS3的压缩包匹配解压策略，会自动触发解压。创建策略前已存在的压缩包不会触发解压。
权限要求：创建策略必须是桶所有者（BucketOwner）或者拥有PutBucketDecompressPolicy权限。
费用说明：KS3会根据解压后文件的实际大小收取文件解压费用，2024年10月1日起，在线解压功能会进行收费。相关计费细节请参见：计费方式和计量项说明。
1. 解压成功之后存储在KS3内的文件存储类型指定为标准存储，访问控制指定为私密。如需修改，需重新设置文件的存储类型和访问权限控制。
2. 创建或更新规则后预计2min生效，请2min后进行压缩包上传。
压缩包和文件要求
单个压缩包大小上限：2GB
单个ZIP包内包含文件数量上限：65536个。
解压后单个文件大小上限：5GB。
解压时间限制
ZIP包解压任务最大时长：2h。
在线解压策略数量上限：10条。
功能限制
压缩包的后缀可以为.zip；.rar；.tar；.7zip；.gz，否则不会触发解压。
压缩包名称中不可带有特殊符号和特殊编码，否则解压不成功。
归档的存储类型的ZIP包不支持在线解压，解冻之后也不支持支持解压。
暂不支持将解压后的文件解压到另一个Bucket。
暂不支持嵌套的压缩包解压。即如果解压后的文件中依然包括压缩包，则该压缩包不能再次解压。
暂不支持解压加密压缩包。
暂不支持分卷压缩，只针对单个压缩包。即不支持将多个压缩包解压后的内容进行合并。
建议设置精准的前缀，同一个桶下的不同触发条件不能包含或重叠，触发条件指策略配置项中的事件、前缀以及后缀。
目标目录：如果不设置解压文件的存放目录，KS3会将生成的文件存放到当前桶的主目录下。
如果压缩包中包含非UTF-8或GB 2312编码的文件名或文件夹（文件目录）名，可能导致解压生成文件的文件名或文件目录名出现乱码、解压过程中断等情况，请使用UTF-8或GB 2312编码命名您的文件或文件目录。
上传归档存储类型的压缩包，不会触发解压功能。
单个压缩包的最长解压处理时间为2小时，超过2小时未完成会解压失败。
KS3支持通过控制台、API方式、Java SDK新建在线解压策略。
创建在线解压策略
登录KS3控制台。
点击左侧的【存储空间】页签，进入存储空间列表。
点击目标存储空间名称，进入存储空间内，点击【空间设置】。
在空间设置界面找到对应的页签【在线解压】。
点击创建策略按钮，进入创建在线策略界面。
配置在线解压策略，参数说明如下表所示。
参数 | 是否必选 | 说明 |
策略名称 | 是 | 输入方便记忆的策略名称。 只能由大写或小写的英文字母、数字、下划线（_）和连字符（-）组成，长度为1~256个字符。例如：test。 |
触发事件 | 是 | 事件类型，目前KS3支持对以下事件类型进行在线解压。
|
前缀 | 否 | 配置触发在线解压的压缩包名称前缀。
不支持\:*?\"<>|特殊字符、不支持第一个字符为"/"或包含“//”，前缀加后缀的长度不得超过512个字符。 |
后缀 | 是 | 解压策略将匹配名称中带有该后缀的压缩包。
|
覆盖同名文件 | 否 | 当解压出的对象与桶内已有对象同名时的处理方式，默认不覆盖。
|
目标目录 | 否 | 指定解压后在目标桶的输出文件的前缀，不填则默认保存在存储桶根路径。 文件解压后存放的路径，不支持\:*?\"<>|特殊字符，不支持以英文句号（.）开头或结尾，不支持包含两个以上相邻的斜杠（/）。 |
额外路径 | 否 | 指定解压后的文件路径是否需要替换压缩包前缀，默认保留压缩文件名，支持如下配置：
|
设置回调 | 否 | 是否开启回调通知。
|
点击确定按钮，完成在线解压策略创建。
注：API操作流程请参见文档：PUT Bucket Decompress Policy。
纯净模式
