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。
更多授权请参见 支持 CAM 的业务接口，如有任何疑问或需要进一步的帮助，请 联系我们。
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 | 此选项决定是否启用删除文件时的错误输出（默认为 |
无 | --fail-output-path | 此选项用于指定记录删除文件时的错误输出文件夹。通过提供自定义文件夹路径，您可以控制错误输出文件夹的位置和名称。如果未设置此选项，将使用默认的错误日志文件夹 |
无 | --all-versions | 仅支持在已开启版本控制的Bucket内且传入 --recursive（-r） 参数时可用，遍历删除指定路径下所有版本 |
无 | --version-id | 仅支持在已开启版本控制的Bucket内且未传入--recursive（-r） 参数时可用，删除指定object的指定版本 |
说明：
--include 和--exclude 支持标准正则表达式的语法，您可以使用它来过滤出符合特定条件的文件。
使用 zsh 时，您可能需要在 pattern 串的两端加上双引号。
./coscli rm cos://bucket1/example/ -r --include ".*\.mp4$"
关于此命令的其他通用选项（例如切换存储桶、切换用户账号等），请参见 通用选项 文档。
