rm 命令用于删除文件。
注意:
使用 rm 命令,请下载 COSCLI V1.0.1及以上版本,详情请参见 下载与安装配置。
若您当前 COSCLI 的版本为 V1.0.0,请您务必升级版本至 V1.0.1后,再执行 rm 删除命令。V1.0.0版本在执行 rm 命令时,--Include 和--exclude 参数不生效,可能会导致非预期的删除情况。
如需使用此命令删除对象,在您进行 授权策略 时,action 需要设置为
cos:HeadBucket,cos:HeadObject,cos:GetBucket,cos:DeleteObject,cos:DeleteMultipleObjects。如需使用此命令删除历史版本(如传入--all-versions 或--version-id),在您进行 授权策略 时,action 需要设置为
cos:HeadBucket,cos:HeadObject,cos:GetBucket,cos:DeleteObject,cos:DeleteMultipleObjects,cos:GetBucketVersioning,cos:GetBucketObjectVersions。命令格式
./coscli rm cos://<bucket-name>[/prefix/] [flag]
rm 命令包含以下参数:
参数格式 | 参数用途 | 示例 |
cos://<bucket-name> | 使用桶别名访问:cos://example-alias 使用桶名称访问:cos://examplebucket-1250000000 | |
/prefix/ | 可选参数。指定某一文件夹。 | /picture/ |
rm 命令包含以下可选 flag:
flag 简写 | flag 全称 | flag 用途 |
-h | --help | 查看该命令的具体用法。 |
无 | --include | 包含特定模式的文件。 |
无 | --exclude | 排除特定模式的文件。 |
-r | --recursive | 是否递归地遍历文件夹下所有文件。 |
-f | --force | 强制删除(删除文件前不弹出确认信息)。 |
无 | --fail-output | 此选项决定是否启用删除文件时的错误输出(默认为 true,开启)。如果启用,文件删除失败将被记录在指定目录内(如果没有指定,默认为./coscli_output)。如果禁用,只会将删除错误文件的数量输出到控制台。 |
无 | --fail-output-path | 此选项用于指定记录删除文件时的错误输出文件夹。通过提供自定义文件夹路径,您可以控制错误输出文件夹的位置和名称。如果未设置此选项,将使用默认的错误日志文件夹 ./coscli_output。 |
无 | --all-versions | 仅支持在已开启版本控制的Bucket内且传入 --recursive(-r) 参数时可用,遍历删除指定路径下所有版本 |
无 | --version-id | 仅支持在已开启版本控制的Bucket内且未传入--recursive(-r) 参数时可用,删除指定object的指定版本 |
说明:
--include 和--exclude 支持标准正则表达式的语法,您可以使用它来过滤出符合特定条件的文件。使用 zsh 时,您可能需要在 pattern 串的两端加上双引号。
./coscli rm cos://bucket1/example/ -r --include ".*\\.mp4$"
关于此命令的其他通用选项(例如切换存储桶、切换用户账号等),请参见 通用选项 文档。
操作示例
删除 fig1.png 文件
./coscli rm cos://bucket1/fig1.png
删除 picture 文件夹及包含的所有内容
./coscli rm cos://bucket1/picture/ -r
删除 fig1.png 文件的指定版本
./coscli rm cos://bucket1/fig1.png --version-id xxx
删除 test 前缀的所有版本
./coscli rm cos://bucket1/test -r --all-versions