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