tencent cloud

All product documents
Cloud Object Storage
DocumentationCloud Object StorageUser ToolsCOSCLI (Beta)Common CommandsDeleting Objects - rm
Deleting Objects - rm
Download PDF
Last updated: 2025-01-08 15:21:15
Deleting Objects - rm
Last updated: 2025-01-08 15:21:15
Download PDF
The rm command is used to delete an object.
Note：
To use the rm command, please download COSCLI V1.0.1 or above. For details, see Download and Installation Configuration.
If your current version of COSCLI is V1.0.0, please upgrade to V1.0.1 before executing the rm command. In V1.0.0, the --include and --exclude parameters do not work when executing the rm command, which may lead to unexpected deletion situations.
If you have any questions or need further assistance, please contact us.

Command Syntax

./coscli rm cos://<bucket-name>[/prefix/] [flag]
rm includes the following parameters:
Parameter Format
Description
Example
cos://<bucket-name>
Specifies the target bucket, which is accessible by using the bucket alias or bucket name configured in the configuration file as detailed in Download and Installation Configuration. If you use the bucket name for access, you also need to include the endpoint flag.
Access with the bucket alias: cos://example-alias
Access with the bucket name: cos://examplebucket-1250000000
/prefix/
Specifies a directory (optional).
/picture/
rm includes the following optional flags:
Flag Abbreviation
Flag Name
Description
-h
--help
Views the usage of this command.
None
--include
Includes specific objects.
None
--exclude
Excludes specific objects.
-r
--recursive
Specifies whether to traverse all objects in the directory recursively.
-f
--force
Forces deletion (no prompt before the deletion).
None
--fail-output
This option determines whether to enable the error output of files when upload or download fails (The default value is true, enabled). If enabled, failed file transfers will be recorded in the specified directory (If no directory is specified, the default directory ./coscli_output is used). If disabled, only the number of failed files will be output to the console.
None
--fail-output-path
This option is used to specify the error output folder for recording failed file uploads or downloads. By providing a custom folder path, you can control the location and name of the error output folder. If this option is not set, the default error log folder ./coscli_output is used.
Note:
--include and --exclude support standard regular expression syntax, so you can use them to filter out objects that meet specific criteria.
When using zsh, you may need to add double quotes at both ends of the pattern string.
  ./coscli rm cos://bucket1/example/ -r --include ".*\.mp4$"
For more general options for this command (such as switching buckets or user accounts), see Common Options.

Example

Deleting an object

./coscli rm cos://bucket1/fig1.png

Deleting all objects in the picture directory

./coscli rm cos://bucket1/pictrue/ -r

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon