删除文件 - rm
最后更新时间：2025-05-09 18:22:05
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
文档反馈