2016-08-04 04:36:28 +08:00
|
|
|
---
|
|
|
|
title: "rclone delete"
|
2021-02-02 21:42:35 +08:00
|
|
|
description: "Remove the files in path."
|
2022-12-21 01:16:14 +08:00
|
|
|
versionIntroduced: v1.27
|
2020-02-10 20:31:45 +08:00
|
|
|
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/delete/ and as part of making a release run "make commanddocs"
|
2016-08-04 04:36:28 +08:00
|
|
|
---
|
2020-05-22 18:17:37 +08:00
|
|
|
# rclone delete
|
2016-08-04 04:36:28 +08:00
|
|
|
|
2021-02-02 21:42:35 +08:00
|
|
|
Remove the files in path.
|
2016-08-04 04:36:28 +08:00
|
|
|
|
2020-05-22 18:17:37 +08:00
|
|
|
## Synopsis
|
2016-08-04 04:36:28 +08:00
|
|
|
|
2022-07-10 01:08:20 +08:00
|
|
|
Remove the files in path. Unlike [purge](/commands/rclone_purge/) it
|
|
|
|
obeys include/exclude filters so can be used to selectively delete files.
|
2016-08-04 04:36:28 +08:00
|
|
|
|
2021-02-02 21:42:35 +08:00
|
|
|
`rclone delete` only deletes files but leaves the directory structure
|
2018-11-24 21:44:25 +08:00
|
|
|
alone. If you want to delete a directory and all of its contents use
|
2022-07-10 01:08:20 +08:00
|
|
|
the [purge](/commands/rclone_purge/) command.
|
2018-11-24 21:44:25 +08:00
|
|
|
|
2021-02-02 21:42:35 +08:00
|
|
|
If you supply the `--rmdirs` flag, it will remove all empty directories along with it.
|
2022-07-10 01:08:20 +08:00
|
|
|
You can also use the separate command [rmdir](/commands/rclone_rmdir/) or
|
|
|
|
[rmdirs](/commands/rclone_rmdirs/) to delete empty directories only.
|
2020-05-16 22:11:55 +08:00
|
|
|
|
2021-06-08 23:57:04 +08:00
|
|
|
For example, to delete all files bigger than 100 MiB, you may first want to
|
|
|
|
check what would be deleted (use either):
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
rclone --min-size 100M lsl remote:path
|
|
|
|
rclone --dry-run --min-size 100M delete remote:path
|
|
|
|
|
2021-02-02 21:42:35 +08:00
|
|
|
Then proceed with the actual delete:
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
rclone --min-size 100M delete remote:path
|
|
|
|
|
2021-03-03 03:11:57 +08:00
|
|
|
That reads "delete everything with a minimum size of 100 MiB", hence
|
2021-06-08 23:57:04 +08:00
|
|
|
delete all files bigger than 100 MiB.
|
2016-08-04 04:36:28 +08:00
|
|
|
|
2020-09-02 23:59:04 +08:00
|
|
|
**Important**: Since this can cause data loss, test first with the
|
|
|
|
`--dry-run` or the `--interactive`/`-i` flag.
|
|
|
|
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
```
|
2017-09-30 21:19:47 +08:00
|
|
|
rclone delete remote:path [flags]
|
|
|
|
```
|
|
|
|
|
2020-05-22 18:17:37 +08:00
|
|
|
## Options
|
2017-09-30 21:19:47 +08:00
|
|
|
|
|
|
|
```
|
2020-05-16 22:11:55 +08:00
|
|
|
-h, --help help for delete
|
|
|
|
--rmdirs rmdirs removes empty directories but leaves root intact
|
2016-08-04 04:36:28 +08:00
|
|
|
```
|
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
Options shared with other commands are described next.
|
|
|
|
See the [global flags page](/flags/) for global options not listed here.
|
2023-08-02 17:02:38 +08:00
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
### Important Options
|
2023-08-02 17:02:38 +08:00
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
Important flags useful for most commands
|
2023-08-02 17:02:38 +08:00
|
|
|
|
|
|
|
```
|
|
|
|
-n, --dry-run Do a trial run with no permanent changes
|
|
|
|
-i, --interactive Enable interactive mode
|
|
|
|
-v, --verbose count Print lots more stuff (repeat for more)
|
|
|
|
```
|
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
### Filter Options
|
2023-08-02 17:02:38 +08:00
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
Flags for filtering directory listings
|
2023-08-02 17:02:38 +08:00
|
|
|
|
|
|
|
```
|
|
|
|
--delete-excluded Delete files on dest excluded from sync
|
|
|
|
--exclude stringArray Exclude files matching pattern
|
|
|
|
--exclude-from stringArray Read file exclude patterns from file (use - to read from stdin)
|
|
|
|
--exclude-if-present stringArray Exclude directories if filename is present
|
|
|
|
--files-from stringArray Read list of source-file names from file (use - to read from stdin)
|
|
|
|
--files-from-raw stringArray Read list of source-file names from file without any processing of lines (use - to read from stdin)
|
|
|
|
-f, --filter stringArray Add a file filtering rule
|
|
|
|
--filter-from stringArray Read file filtering patterns from a file (use - to read from stdin)
|
|
|
|
--ignore-case Ignore case in filters (case insensitive)
|
|
|
|
--include stringArray Include files matching pattern
|
|
|
|
--include-from stringArray Read file include patterns from file (use - to read from stdin)
|
|
|
|
--max-age Duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off)
|
|
|
|
--max-depth int If set limits the recursion depth to this (default -1)
|
|
|
|
--max-size SizeSuffix Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off)
|
|
|
|
--metadata-exclude stringArray Exclude metadatas matching pattern
|
|
|
|
--metadata-exclude-from stringArray Read metadata exclude patterns from file (use - to read from stdin)
|
|
|
|
--metadata-filter stringArray Add a metadata filtering rule
|
|
|
|
--metadata-filter-from stringArray Read metadata filtering patterns from a file (use - to read from stdin)
|
|
|
|
--metadata-include stringArray Include metadatas matching pattern
|
|
|
|
--metadata-include-from stringArray Read metadata include patterns from file (use - to read from stdin)
|
|
|
|
--min-age Duration Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off)
|
|
|
|
--min-size SizeSuffix Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off)
|
|
|
|
```
|
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
### Listing Options
|
2023-08-02 17:02:38 +08:00
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
Flags for listing directories
|
2023-08-02 17:02:38 +08:00
|
|
|
|
|
|
|
```
|
|
|
|
--default-time Time Time to show if modtime is unknown for files and directories (default 2000-01-01T00:00:00Z)
|
|
|
|
--fast-list Use recursive list if available; uses more memory but fewer transactions
|
|
|
|
```
|
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
## See Also
|
2016-08-04 04:36:28 +08:00
|
|
|
|
2018-10-15 18:03:08 +08:00
|
|
|
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
|
2018-03-19 18:06:13 +08:00
|
|
|
|