全部文档
当前文档
最近更新时间：2025-11-07 14:58:06
rm用于删除存储在KS3存储桶内的文件或者碎片。
1. 如果没有开启回收站功能，文件被删除后将无法恢复，请谨慎操作。建议开启回收站功能，回收站开启后删除的文件将进入回收站，回收站内的文件支持恢复。
2. 以下示例均以Linux为例。
./ks3util rm ks3://bucketname[/prefix]
[-r, --recursive]
[-f, --force]
[-b, --bucket]
[-m, --multipart]
[-a, --all-type]
[--include <value>]
[--exclude <value>]
[--time-range <value>]
[--only-current-dir]
[--retention]
[--retention-id <value>]
[-j, --jobs <value>]参数 | 说明 |
|---|---|
bucketname | 操作的桶名。 |
prefix | 操作的对象的前缀。 |
-r, --recursive | 递归进行操作。当指定该选项时，会对存储空间下所有符合条件的对象进行操作，否则只对路径指定的定的单个对象进行操作。 |
-f, --force | 强制操作，不进行询问提示。 |
-b, --bucket | 对Bucket进行操作，该选项用于确认操作作用于Bucket。 |
-m, --multipart | 指定操作的对象为Bucket中未完成的Multipart事件，而非默认情况下的Object。 |
-a, --all-type | 指定操作的对象为Bucket中符合prefix条件的Object和未完成的Multipart事件。 |
--include | 包含对象匹配模式，满足匹配规则的文件将会被选中，如：*.jpg。 该选项可以出现多次，多个--include规则取并集。 |
--exclude | 不包含对象匹配模式，满足匹配规则的文件将会被排除，如：*.txt。 该选项可以出现多次，多个--exclude规则取并集。。 |
--time-range | 时间段匹配模式，仅匹配最后修改时间在该时间段内的文件。时间段格式为：time1-time2，其中time1、time2需要填写UTC时间，格式为：yyyyMMddHHmmss。 详细请参考通用选项&过滤规则文档。 |
--only-current-dir | 表示仅操作当前目录下的文件，忽略子目录。 |
--retention | 表示删除回收站中全部版本的对象。 |
--retention-id | 指定回收站内被删除对象的retentionId，表示删除指定版本的对象。该参数不支持与--retention同时使用。 |
-j, --jobs | 多文件操作时的并发数，默认值：5，取值范围：1-10000。 |
除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
示例一：删除单个文件。
./ks3util rm ks3://samplebucket/src-prefix/sample.txt示例二：批量删除文件。
删除指定前缀的文件。
./ks3util rm ks3://samplebucket/src-prefix/ -r按匹配条件删除。
./ks3util rm ks3://samplebucket/src-prefix/ -r --include *screenshot* --exclude *important*按指定列表文件进行删除。
./ks3util rm ks3://samplebucket/ --object-file object_keys_file注：object_keys_file为本地.txt文件的路径，文件内填写指定Object列表，每个objectKey为一行（不包含ks3://bucket/ 部分）。
示例三：删除指定目录下的文件，不递归子目录。
./ks3util rm ks3://samplebucket/abc/ -r --only-current-dir示例四：删除回收站内文件。
指定文件的指定版本。
./ks3util rm ks3://bucketname/sample.txt --retention-id xxxxxx指定文件的全部版本。
./ks3util rm ks3://bucketname/sample.txt --retention删除回收站内指定前缀的所有文件的所有版本。
./ks3util rm ks3://bucketname/abc --retention -r示例五：删除最后修改时间在指定范围的文件。
./ks3util rm ks3://samplebucket/src-prefix/ -r --time-range "20241106120000-20241110120000"示例一：删除单文件碎片。
删除单个文件未完成的Multipart事件产生的Part。
./ks3util rm ks3://samplebucket/src-prefix/sample.txt -m删除单个文件、以及未完成的Multipart事件所产生的Part。
./ks3util rm ks3://samplebucket/src-prefix/sample.txt -a示例二：删除指定前缀文件碎片。
删除指定前缀的所有文件未完成的Multipart事件产生的Part。
./ks3util rm ks3://samplebucket/src-prefix/ -m -r删除指定前缀的所有文件、以及未完成的Multipart事件所产生的Part。
./ks3util rm ks3://samplebucket/src-prefix/ -a -r删除匹配条件的文件未完成的Multipart事件产生的Part。
./ks3util rm ks3://samplebucket/src-prefix/ -m -r --include *screenshot* --exclude *important*删除匹配条件的文件、以及未完成的Multipart事件产生的Part。
./ks3util rm ks3://samplebucket/src-prefix/ -a -r --include *screenshot* --exclude *important*纯净模式