全部文档
当前文档
最近更新时间：2025-11-07 14:47:20
recover命令用于恢复Bucket回收站中的文件。有关恢复规则的更多详情请参见文档：Recover Object。
以下示例均以Linux为例。
./ks3util recover ks3://bucketname[/prefix]
[-r, --recursive]
[-f, --force]
[--retention-id <value>]
[--retention-overwrite]
[--include <value>]
[--exclude <value>]
[-j, --jobs <value>]配置项 | 说明 |
bucketname | 操作的桶名。 |
prefix | 操作的对象的前缀。 |
-r, --recursive | 递归进行操作。当指定该选项时，会恢复存储空间下所有符合条件的对象为最近的版本，否则只恢复路径指定的单个对象为最近的版本。该选项不能与--retention-id同时使用。 |
--retention-id | 指定被恢复Object的删除ID。当不带该选项时，默认只恢复最新的一个版本。 |
--retention-overwrite | 从回收站内被恢复的Object在Bucket中存在同名Object时，是否支持覆盖。当取值为true时表示覆盖，Bucket内被覆盖的Object会进入回收站。 |
--include | 包含对象匹配模式，满足匹配规则的文件将会被选中，如：*.jpg。 该选项可以出现多次，多个--include规则取并集。 |
--exclude | 不包含对象匹配模式，满足匹配规则的文件将会被排除，如：*.txt。 该选项可以出现多次，多个--exclude规则取并集。 |
-j, --jobs | 多文件操作时的并发任务数，默认值：5，取值范围：1-10000。 |
除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
示例一：恢复单个文件为最近版本。
./ks3util recover ks3://samplebucket/sample.txt示例二：恢复单个文件为指定版本。
./ks3util recover ks3://samplebucket/sample.txt --retention-id xxxxxx示例三：恢复单个文件为最近版本，若Bucket中存在同名文件时强制覆盖。
./ks3util recover ks3://samplebucket/sample.txt --retention-overwrite示例四：恢复指定前缀下文件为最近版本。
./ks3util recover ks3://samplebucket/src-prefix/ -r示例五：恢复指定前缀下文件为最近版本，若Bucket中存在同名文件时强制覆盖。
./ks3util recover ks3://samplebucket/src-prefix/ -r --retention-overwrite纯净模式