1
0
mirror of https://github.com/rclone/rclone.git synced 2025-11-23 21:44:49 +02:00

docs: fix markdownlint issues and other styling improvements in backend command docs

This commit is contained in:
albertony
2025-11-02 13:19:36 +01:00
parent 7265b2331f
commit 2aa2cfc70e
11 changed files with 386 additions and 408 deletions

View File

@@ -2360,8 +2360,6 @@ var lifecycleHelp = fs.CommandHelp{
Short: "Read or set the lifecycle for a bucket.", Short: "Read or set the lifecycle for a bucket.",
Long: `This command can be used to read or set the lifecycle for a bucket. Long: `This command can be used to read or set the lifecycle for a bucket.
Usage Examples:
To show the current lifecycle rules: To show the current lifecycle rules:
` + "```console" + ` ` + "```console" + `
@@ -2381,7 +2379,7 @@ This will dump something like this showing the lifecycle rules.
] ]
` + "```" + ` ` + "```" + `
If there are no lifecycle rules (the default) then it will just return []. If there are no lifecycle rules (the default) then it will just return ` + "`[]`" + `.
To reset the current lifecycle rules: To reset the current lifecycle rules:
@@ -2404,12 +2402,13 @@ overwrites will still cause versions to be made.
rclone backend lifecycle b2:bucket -o daysFromHidingToDeleting=1 rclone backend lifecycle b2:bucket -o daysFromHidingToDeleting=1
` + "```" + ` ` + "```" + `
See: https://www.backblaze.com/docs/cloud-storage-lifecycle-rules See: <https://www.backblaze.com/docs/cloud-storage-lifecycle-rules>`,
`,
Opts: map[string]string{ Opts: map[string]string{
"daysFromHidingToDeleting": "After a file has been hidden for this many days it is deleted. 0 is off.", "daysFromHidingToDeleting": `After a file has been hidden for this many days
"daysFromUploadingToHiding": "This many days after uploading a file is hidden", it is deleted. 0 is off.`,
"daysFromStartingToCancelingUnfinishedLargeFiles": "Cancels any unfinished large file versions after this many days", "daysFromUploadingToHiding": `This many days after uploading a file is hidden.`,
"daysFromStartingToCancelingUnfinishedLargeFiles": `Cancels any unfinished
large file versions after this many days.`,
}, },
} }
@@ -2497,10 +2496,9 @@ rclone backend cleanup b2:bucket/path/to/object
rclone backend cleanup -o max-age=7w b2:bucket/path/to/object rclone backend cleanup -o max-age=7w b2:bucket/path/to/object
` + "```" + ` ` + "```" + `
Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc. Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc.`,
`,
Opts: map[string]string{ Opts: map[string]string{
"max-age": "Max age of upload to delete", "max-age": "Max age of upload to delete.",
}, },
} }
@@ -2525,8 +2523,7 @@ it would do.
` + "```console" + ` ` + "```console" + `
rclone backend cleanup-hidden b2:bucket/path/to/dir rclone backend cleanup-hidden b2:bucket/path/to/dir
` + "```" + ` ` + "```",
`,
} }
func (f *Fs) cleanupHiddenCommand(ctx context.Context, name string, arg []string, opt map[string]string) (out any, err error) { func (f *Fs) cleanupHiddenCommand(ctx context.Context, name string, arg []string, opt map[string]string) (out any, err error) {

View File

@@ -927,13 +927,12 @@ var commandHelp = []fs.CommandHelp{
Long: `This encodes the filenames given as arguments returning a list of Long: `This encodes the filenames given as arguments returning a list of
strings of the encoded results. strings of the encoded results.
Usage Example: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend encode crypt: file1 [file2...] rclone backend encode crypt: file1 [file2...]
rclone rc backend/command command=encode fs=crypt: file1 [file2...] rclone rc backend/command command=encode fs=crypt: file1 [file2...]
` + "```" + ` ` + "```",
`,
}, },
{ {
Name: "decode", Name: "decode",
@@ -942,13 +941,12 @@ rclone rc backend/command command=encode fs=crypt: file1 [file2...]
strings of the decoded results. It will return an error if any of the strings of the decoded results. It will return an error if any of the
inputs are invalid. inputs are invalid.
Usage Example: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend decode crypt: encryptedfile1 [encryptedfile2...] rclone backend decode crypt: encryptedfile1 [encryptedfile2...]
rclone rc backend/command command=decode fs=crypt: encryptedfile1 [encryptedfile2...] rclone rc backend/command command=decode fs=crypt: encryptedfile1 [encryptedfile2...]
` + "```" + ` ` + "```",
`,
}, },
} }

View File

@@ -569,8 +569,7 @@ Usage example:
rclone backend metadata doi: rclone backend metadata doi:
` + "```" + ` ` + "```" + `
It returns a JSON object representing metadata about the DOI. It returns a JSON object representing metadata about the DOI.`,
`,
}, { }, {
Name: "set", Name: "set",
Short: "Set command for updating the config parameters.", Short: "Set command for updating the config parameters.",
@@ -591,8 +590,7 @@ This rebuilds the connection to the doi backend when it is called with
the new parameters. Only new parameters need be passed as the values the new parameters. Only new parameters need be passed as the values
will default to those currently in use. will default to those currently in use.
It doesn't return anything. It doesn't return anything.`,
`,
}} }}
// Command the backend to run a named command // Command the backend to run a named command

View File

@@ -3665,41 +3665,41 @@ func (f *Fs) rescue(ctx context.Context, dirID string, delete bool) (err error)
var commandHelp = []fs.CommandHelp{{ var commandHelp = []fs.CommandHelp{{
Name: "get", Name: "get",
Short: "Get command for fetching the drive config parameters.", Short: "Get command for fetching the drive config parameters.",
Long: `This is a get command which will be used to fetch the various drive config parameters Long: `This is a get command which will be used to fetch the various drive config
parameters.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend get drive: [-o service_account_file] [-o chunk_size] rclone backend get drive: [-o service_account_file] [-o chunk_size]
rclone rc backend/command command=get fs=drive: [-o service_account_file] [-o chunk_size] rclone rc backend/command command=get fs=drive: [-o service_account_file] [-o chunk_size]
` + "```" + ` ` + "```",
`,
Opts: map[string]string{ Opts: map[string]string{
"chunk_size": "show the current upload chunk size", "chunk_size": "Show the current upload chunk size.",
"service_account_file": "show the current service account file", "service_account_file": "Show the current service account file.",
}, },
}, { }, {
Name: "set", Name: "set",
Short: "Set command for updating the drive config parameters.", Short: "Set command for updating the drive config parameters.",
Long: `This is a set command which will be used to update the various drive config parameters Long: `This is a set command which will be used to update the various drive config
parameters.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend set drive: [-o service_account_file=sa.json] [-o chunk_size=67108864] rclone backend set drive: [-o service_account_file=sa.json] [-o chunk_size=67108864]
rclone rc backend/command command=set fs=drive: [-o service_account_file=sa.json] [-o chunk_size=67108864] rclone rc backend/command command=set fs=drive: [-o service_account_file=sa.json] [-o chunk_size=67108864]
` + "```" + ` ` + "```",
`,
Opts: map[string]string{ Opts: map[string]string{
"chunk_size": "update the current upload chunk size", "chunk_size": "Update the current upload chunk size.",
"service_account_file": "update the current service account file", "service_account_file": "Update the current service account file.",
}, },
}, { }, {
Name: "shortcut", Name: "shortcut",
Short: "Create shortcuts from files or directories.", Short: "Create shortcuts from files or directories.",
Long: `This command creates shortcuts from files or directories. Long: `This command creates shortcuts from files or directories.
Usage: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend shortcut drive: source_item destination_shortcut rclone backend shortcut drive: source_item destination_shortcut
@@ -3714,10 +3714,9 @@ from "drive:"
In the second example this creates a shortcut from the "source_item" In the second example this creates a shortcut from the "source_item"
relative to "drive:" to the "destination_shortcut" relative to relative to "drive:" to the "destination_shortcut" relative to
"drive2:". This may fail with a permission error if the user "drive2:". This may fail with a permission error if the user
authenticated with "drive2:" can't read files from "drive:". authenticated with "drive2:" can't read files from "drive:".`,
`,
Opts: map[string]string{ Opts: map[string]string{
"target": "optional target remote for the shortcut destination", "target": "Optional target remote for the shortcut destination.",
}, },
}, { }, {
Name: "drives", Name: "drives",
@@ -3725,7 +3724,7 @@ authenticated with "drive2:" can't read files from "drive:".
Long: `This command lists the Shared Drives (Team Drives) available to this Long: `This command lists the Shared Drives (Team Drives) available to this
account. account.
Usage: Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend [-o config] drives drive: rclone backend [-o config] drives drive:
@@ -3770,15 +3769,14 @@ Adding this to the rclone config file will cause those team drives to
be accessible with the aliases shown. Any illegal characters will be be accessible with the aliases shown. Any illegal characters will be
substituted with "_" and duplicate names will have numbers suffixed. substituted with "_" and duplicate names will have numbers suffixed.
It will also add a remote called AllDrives which shows all the shared It will also add a remote called AllDrives which shows all the shared
drives combined into one directory tree. drives combined into one directory tree.`,
`,
}, { }, {
Name: "untrash", Name: "untrash",
Short: "Untrash files and directories.", Short: "Untrash files and directories.",
Long: `This command untrashes all the files and directories in the directory Long: `This command untrashes all the files and directories in the directory
passed in recursively. passed in recursively.
Usage: Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend untrash drive:directory rclone backend untrash drive:directory
@@ -3788,7 +3786,8 @@ rclone backend --interactive untrash drive:directory subdir
This takes an optional directory to trash which make this easier to This takes an optional directory to trash which make this easier to
use via the API. use via the API.
Use the --interactive/-i or --dry-run flag to see what would be restored before restoring it. Use the --interactive/-i or --dry-run flag to see what would be restored before
restoring it.
Result: Result:
@@ -3797,14 +3796,13 @@ Result:
"Untrashed": 17, "Untrashed": 17,
"Errors": 0 "Errors": 0
} }
` + "```" + ` ` + "```",
`,
}, { }, {
Name: "copyid", Name: "copyid",
Short: "Copy files by ID.", Short: "Copy files by ID.",
Long: `This command copies files by ID Long: `This command copies files by ID.
Usage: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend copyid drive: ID path rclone backend copyid drive: ID path
@@ -3822,14 +3820,14 @@ component will be used as the file name.
If the destination is a drive backend then server-side copying will be If the destination is a drive backend then server-side copying will be
attempted if possible. attempted if possible.
Use the --interactive/-i or --dry-run flag to see what would be copied before copying. Use the --interactive/-i or --dry-run flag to see what would be copied before
`, copying.`,
}, { }, {
Name: "moveid", Name: "moveid",
Short: "Move files by ID.", Short: "Move files by ID.",
Long: `This command moves files by ID Long: `This command moves files by ID.
Usage: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend moveid drive: ID path rclone backend moveid drive: ID path
@@ -3846,8 +3844,7 @@ component will be used as the file name.
If the destination is a drive backend then server-side moving will be If the destination is a drive backend then server-side moving will be
attempted if possible. attempted if possible.
Use the --interactive/-i or --dry-run flag to see what would be moved beforehand. Use the --interactive/-i or --dry-run flag to see what would be moved beforehand.`,
`,
}, { }, {
Name: "exportformats", Name: "exportformats",
Short: "Dump the export formats for debug purposes.", Short: "Dump the export formats for debug purposes.",
@@ -3857,9 +3854,9 @@ Use the --interactive/-i or --dry-run flag to see what would be moved beforehand
}, { }, {
Name: "query", Name: "query",
Short: "List files using Google Drive query language.", Short: "List files using Google Drive query language.",
Long: `This command lists files based on a query Long: `This command lists files based on a query.
Usage: Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend query drive: query rclone backend query drive: query
@@ -3902,8 +3899,7 @@ The result is a JSON array of matches, for example:
"webViewLink": "https://drive.google.com/file/d/0AxBe_CDEF4zkGHI4d0FjYko2QkD/view?usp=drivesdk\u0026resourcekey=0-ABCDEFGHIXJQpIGqBJq3MC" "webViewLink": "https://drive.google.com/file/d/0AxBe_CDEF4zkGHI4d0FjYko2QkD/view?usp=drivesdk\u0026resourcekey=0-ABCDEFGHIXJQpIGqBJq3MC"
} }
] ]
` + "```console" + ` ` + "```console",
`,
}, { }, {
Name: "rescue", Name: "rescue",
Short: "Rescue or delete any orphaned files.", Short: "Rescue or delete any orphaned files.",
@@ -3915,34 +3911,31 @@ are no longer in any folder in Google Drive.
This command finds those files and either rescues them to a directory This command finds those files and either rescues them to a directory
you specify or deletes them. you specify or deletes them.
Usage:
This can be used in 3 ways. This can be used in 3 ways.
First, list all orphaned files First, list all orphaned files:
` + "```console" + ` ` + "```console" + `
rclone backend rescue drive: rclone backend rescue drive:
` + "```" + ` ` + "```" + `
Second rescue all orphaned files to the directory indicated Second rescue all orphaned files to the directory indicated:
` + "```console" + ` ` + "```console" + `
rclone backend rescue drive: "relative/path/to/rescue/directory" rclone backend rescue drive: "relative/path/to/rescue/directory"
` + "```" + ` ` + "```" + `
e.g. To rescue all orphans to a directory called "Orphans" in the top level E.g. to rescue all orphans to a directory called "Orphans" in the top level:
` + "```console" + ` ` + "```console" + `
rclone backend rescue drive: Orphans rclone backend rescue drive: Orphans
` + "```" + ` ` + "```" + `
Third delete all orphaned files to the trash Third delete all orphaned files to the trash:
` + "```console" + ` ` + "```console" + `
rclone backend rescue drive: -o delete rclone backend rescue drive: -o delete
` + "```" + ` ` + "```",
`,
}} }}
// Command the backend to run a named command // Command the backend to run a named command

View File

@@ -45,20 +45,20 @@ var commandHelp = []fs.CommandHelp{{
Name: "drop", Name: "drop",
Short: "Drop cache.", Short: "Drop cache.",
Long: `Completely drop checksum cache. Long: `Completely drop checksum cache.
Usage Example:
Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend drop hasher: rclone backend drop hasher:
` + "```" + ` ` + "```",
`,
}, { }, {
Name: "dump", Name: "dump",
Short: "Dump the database.", Short: "Dump the database.",
Long: "Dump cache records covered by the current remote", Long: "Dump cache records covered by the current remote.",
}, { }, {
Name: "fulldump", Name: "fulldump",
Short: "Full dump of the database.", Short: "Full dump of the database.",
Long: "Dump all cache records in the database", Long: "Dump all cache records in the database.",
}, { }, {
Name: "import", Name: "import",
Short: "Import a SUM file.", Short: "Import a SUM file.",
@@ -68,8 +68,7 @@ Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend import hasher:subdir md5 /path/to/sum.md5 rclone backend import hasher:subdir md5 /path/to/sum.md5
` + "```" + ` ` + "```",
`,
}, { }, {
Name: "stickyimport", Name: "stickyimport",
Short: "Perform fast import of a SUM file.", Short: "Perform fast import of a SUM file.",
@@ -79,8 +78,7 @@ Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend stickyimport hasher:subdir md5 remote:path/to/sum.md5 rclone backend stickyimport hasher:subdir md5 remote:path/to/sum.md5
` + "```" + ` ` + "```",
`,
}} }}
func (f *Fs) dbDump(ctx context.Context, full bool, root string) error { func (f *Fs) dbDump(ctx context.Context, full bool, root string) error {

View File

@@ -722,7 +722,7 @@ var commandHelp = []fs.CommandHelp{{
Long: `This set command can be used to update the config parameters Long: `This set command can be used to update the config parameters
for a running http backend. for a running http backend.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend set remote: [-o opt_name=opt_value] [-o opt_name2=opt_value2] rclone backend set remote: [-o opt_name=opt_value] [-o opt_name2=opt_value2]
@@ -736,8 +736,7 @@ This rebuilds the connection to the http backend when it is called with
the new parameters. Only new parameters need be passed as the values the new parameters. Only new parameters need be passed as the values
will default to those currently in use. will default to those currently in use.
It doesn't return anything. It doesn't return anything.`,
`,
}} }}
// Command the backend to run a named command // Command the backend to run a named command

View File

@@ -1071,11 +1071,10 @@ var commandHelp = []fs.CommandHelp{
{ {
Name: "noop", Name: "noop",
Short: "A null operation for testing backend commands.", Short: "A null operation for testing backend commands.",
Long: `This is a test command which has some options Long: `This is a test command which has some options you can try to change the output.`,
you can try to change the output.`,
Opts: map[string]string{ Opts: map[string]string{
"echo": "echo the input arguments", "echo": "Echo the input arguments.",
"error": "return an error based on option value", "error": "Return an error based on option value.",
}, },
}, },
} }

View File

@@ -96,7 +96,12 @@ files stored in any sub-directories that may exist.`,
Long: `The desired path location (including applicable sub-directories) ending in Long: `The desired path location (including applicable sub-directories) ending in
the object that will be the target of the symlink (for example, /links/mylink). the object that will be the target of the symlink (for example, /links/mylink).
Include the file extension for the object, if applicable. Include the file extension for the object, if applicable.
` + "`rclone backend symlink <src> <path>`",
Usage example:
` + "```console" + `
rclone backend symlink <src> <path>
` + "```",
}, },
} }

View File

@@ -33,19 +33,18 @@ var commandHelp = []fs.CommandHelp{{
Short: "change the name of an object.", Short: "change the name of an object.",
Long: `This command can be used to rename a object. Long: `This command can be used to rename a object.
Usage Examples: Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend rename oos:bucket relative-object-path-under-bucket object-new-name rclone backend rename oos:bucket relative-object-path-under-bucket object-new-name
` + "```" + ` ` + "```",
`,
Opts: nil, Opts: nil,
}, { }, {
Name: operationListMultiPart, Name: operationListMultiPart,
Short: "List the unfinished multipart uploads.", Short: "List the unfinished multipart uploads.",
Long: `This command lists the unfinished multipart uploads in JSON format. Long: `This command lists the unfinished multipart uploads in JSON format.
Usage Examples: Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend list-multipart-uploads oos:bucket/path/to/object rclone backend list-multipart-uploads oos:bucket/path/to/object
@@ -57,7 +56,6 @@ multipart uploads.
You can call it with no bucket in which case it lists all bucket, with You can call it with no bucket in which case it lists all bucket, with
a bucket or with a bucket and path. a bucket or with a bucket and path.
` + "```json" + ` ` + "```json" + `
{ {
"test-bucket": [ "test-bucket": [
@@ -70,35 +68,34 @@ a bucket or with a bucket and path.
"storageTier": "Standard" "storageTier": "Standard"
} }
] ]
} }`,
`,
}, { }, {
Name: operationCleanup, Name: operationCleanup,
Short: "Remove unfinished multipart uploads.", Short: "Remove unfinished multipart uploads.",
Long: `This command removes unfinished multipart uploads of age greater than Long: `This command removes unfinished multipart uploads of age greater than
max-age which defaults to 24 hours. max-age which defaults to 24 hours.
Note that you can use --interactive/-i or --dry-run with this command to see what Note that you can use --interactive/-i or --dry-run with this command to see
it would do. what it would do.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend cleanup oos:bucket/path/to/object rclone backend cleanup oos:bucket/path/to/object
rclone backend cleanup -o max-age=7w oos:bucket/path/to/object rclone backend cleanup -o max-age=7w oos:bucket/path/to/object
` + "```" + ` ` + "```" + `
Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc. Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc.`,
`,
Opts: map[string]string{ Opts: map[string]string{
"max-age": "Max age of upload to delete", "max-age": "Max age of upload to delete.",
}, },
}, { }, {
Name: operationRestore, Name: operationRestore,
Short: "Restore objects from Archive to Standard storage.", Short: "Restore objects from Archive to Standard storage.",
Long: `This command can be used to restore one or more objects from Archive to Standard storage. Long: `This command can be used to restore one or more objects from Archive to
Standard storage.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend restore oos:bucket/path/to/directory -o hours=HOURS rclone backend restore oos:bucket/path/to/directory -o hours=HOURS
@@ -111,15 +108,14 @@ This flag also obeys the filters. Test first with --interactive/-i or --dry-run
rclone --interactive backend restore --include "*.txt" oos:bucket/path -o hours=72 rclone --interactive backend restore --include "*.txt" oos:bucket/path -o hours=72
` + "```" + ` ` + "```" + `
All the objects shown will be marked for restore, then All the objects shown will be marked for restore, then:
` + "```console" + ` ` + "```console" + `
rclone backend restore --include "*.txt" oos:bucket/path -o hours=72 rclone backend restore --include "*.txt" oos:bucket/path -o hours=72
` + "```" + ` ` + "```" + `
It returns a list of status dictionaries with Object Name and Status It returns a list of status dictionaries with Object Name and Status keys.
keys. The Status will be "RESTORED"" if it was successful or an error message The Status will be "RESTORED"" if it was successful or an error message if not.
if not.
` + "```json" + ` ` + "```json" + `
[ [
@@ -132,10 +128,10 @@ if not.
"Status": "RESTORED", "Status": "RESTORED",
} }
] ]
` + "```" + ` ` + "```",
`,
Opts: map[string]string{ Opts: map[string]string{
"hours": "The number of hours for which this object will be restored. Default is 24 hrs.", "hours": `The number of hours for which this object will be restored.
Default is 24 hrs.`,
}, },
}, },
} }

View File

@@ -1681,21 +1681,20 @@ var commandHelp = []fs.CommandHelp{{
Short: "Add offline download task for url.", Short: "Add offline download task for url.",
Long: `This command adds offline download task for url. Long: `This command adds offline download task for url.
Usage: Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend addurl pikpak:dirpath url rclone backend addurl pikpak:dirpath url
` + "```" + ` ` + "```" + `
Downloads will be stored in 'dirpath'. If 'dirpath' is invalid, Downloads will be stored in 'dirpath'. If 'dirpath' is invalid,
download will fallback to default 'My Pack' folder. download will fallback to default 'My Pack' folder.`,
`,
}, { }, {
Name: "decompress", Name: "decompress",
Short: "Request decompress of a file/files in a folder.", Short: "Request decompress of a file/files in a folder.",
Long: `This command requests decompress of file/files in a folder. Long: `This command requests decompress of file/files in a folder.
Usage: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend decompress pikpak:dirpath {filename} -o password=password rclone backend decompress pikpak:dirpath {filename} -o password=password
@@ -1715,8 +1714,7 @@ Result:
"SourceDeleted": 0, "SourceDeleted": 0,
"Errors": 0 "Errors": 0
} }
` + "```" + ` ` + "```",
`,
}} }}
// Command the backend to run a named command // Command the backend to run a named command

View File

@@ -2903,10 +2903,11 @@ func (f *Fs) PublicLink(ctx context.Context, remote string, expire fs.Duration,
var commandHelp = []fs.CommandHelp{{ var commandHelp = []fs.CommandHelp{{
Name: "restore", Name: "restore",
Short: "Restore objects from GLACIER or INTELLIGENT-TIERING archive tier.", Short: "Restore objects from GLACIER or INTELLIGENT-TIERING archive tier.",
Long: `This command can be used to restore one or more objects from GLACIER to normal storage Long: `This command can be used to restore one or more objects from GLACIER to normal
or from INTELLIGENT-TIERING Archive Access / Deep Archive Access tier to the Frequent Access tier. storage or from INTELLIGENT-TIERING Archive Access / Deep Archive Access tier
to the Frequent Access tier.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend restore s3:bucket/path/to/ --include /object -o priority=PRIORITY -o lifetime=DAYS rclone backend restore s3:bucket/path/to/ --include /object -o priority=PRIORITY -o lifetime=DAYS
@@ -2915,13 +2916,14 @@ rclone backend restore s3:bucket -o priority=PRIORITY -o lifetime=DAYS
rclone backend restore s3:bucket/path/to/directory -o priority=PRIORITY rclone backend restore s3:bucket/path/to/directory -o priority=PRIORITY
` + "```" + ` ` + "```" + `
This flag also obeys the filters. Test first with --interactive/-i or --dry-run flags This flag also obeys the filters. Test first with --interactive/-i or --dry-run
flags.
` + "```console" + ` ` + "```console" + `
rclone --interactive backend restore --include "*.txt" s3:bucket/path -o priority=Standard -o lifetime=1 rclone --interactive backend restore --include "*.txt" s3:bucket/path -o priority=Standard -o lifetime=1
` + "```" + ` ` + "```" + `
All the objects shown will be marked for restore, then All the objects shown will be marked for restore, then:
` + "```console" + ` ` + "```console" + `
rclone backend restore --include "*.txt" s3:bucket/path -o priority=Standard -o lifetime=1 rclone backend restore --include "*.txt" s3:bucket/path -o priority=Standard -o lifetime=1
@@ -2942,20 +2944,21 @@ if not.
"Remote": "test/file4.txt" "Remote": "test/file4.txt"
} }
] ]
` + "```" + ` ` + "```",
`,
Opts: map[string]string{ Opts: map[string]string{
"priority": "Priority of restore: Standard|Expedited|Bulk", "priority": "Priority of restore: Standard|Expedited|Bulk",
"lifetime": "Lifetime of the active copy in days, ignored for INTELLIGENT-TIERING storage", "lifetime": `Lifetime of the active copy in days, ignored for INTELLIGENT-TIERING
storage.`,
"description": "The optional description for the job.", "description": "The optional description for the job.",
}, },
}, { }, {
Name: "restore-status", Name: "restore-status",
Short: "Show the restore status for objects being restored from GLACIER or INTELLIGENT-TIERING storage.", Short: "Show the status for objects being restored from GLACIER or INTELLIGENT-TIERING.",
Long: `This command can be used to show the status for objects being restored from GLACIER to normal storage Long: `This command can be used to show the status for objects being restored from
or from INTELLIGENT-TIERING Archive Access / Deep Archive Access tier to the Frequent Access tier. GLACIER to normal storage or from INTELLIGENT-TIERING Archive Access / Deep
Archive Access tier to the Frequent Access tier.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend restore-status s3:bucket/path/to/object rclone backend restore-status s3:bucket/path/to/object
@@ -2965,7 +2968,7 @@ rclone backend restore-status -o all s3:bucket/path/to/directory
This command does not obey the filters. This command does not obey the filters.
It returns a list of status dictionaries. It returns a list of status dictionaries:
` + "```json" + ` ` + "```json" + `
[ [
@@ -2997,17 +3000,16 @@ It returns a list of status dictionaries.
"StorageClass": "INTELLIGENT_TIERING" "StorageClass": "INTELLIGENT_TIERING"
} }
] ]
` + "```" + ` ` + "```",
`,
Opts: map[string]string{ Opts: map[string]string{
"all": "if set then show all objects, not just ones with restore status", "all": "If set then show all objects, not just ones with restore status.",
}, },
}, { }, {
Name: "list-multipart-uploads", Name: "list-multipart-uploads",
Short: "List the unfinished multipart uploads.", Short: "List the unfinished multipart uploads.",
Long: `This command lists the unfinished multipart uploads in JSON format. Long: `This command lists the unfinished multipart uploads in JSON format.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend list-multipart s3:bucket/path/to/object rclone backend list-multipart s3:bucket/path/to/object
@@ -3040,28 +3042,26 @@ a bucket or with a bucket and path.
"rclone-1000files": [], "rclone-1000files": [],
"rclone-dst": [] "rclone-dst": []
} }
` + "```" + ` ` + "```",
`,
}, { }, {
Name: "cleanup", Name: "cleanup",
Short: "Remove unfinished multipart uploads.", Short: "Remove unfinished multipart uploads.",
Long: `This command removes unfinished multipart uploads of age greater than Long: `This command removes unfinished multipart uploads of age greater than
max-age which defaults to 24 hours. max-age which defaults to 24 hours.
Note that you can use --interactive/-i or --dry-run with this command to see what Note that you can use --interactive/-i or --dry-run with this command to see
it would do. what it would do.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend cleanup s3:bucket/path/to/object rclone backend cleanup s3:bucket/path/to/object
rclone backend cleanup -o max-age=7w s3:bucket/path/to/object rclone backend cleanup -o max-age=7w s3:bucket/path/to/object
` + "```" + ` ` + "```" + `
Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc. Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc.`,
`,
Opts: map[string]string{ Opts: map[string]string{
"max-age": "Max age of upload to delete", "max-age": "Max age of upload to delete.",
}, },
}, { }, {
Name: "cleanup-hidden", Name: "cleanup-hidden",
@@ -3069,15 +3069,14 @@ Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc.
Long: `This command removes any old hidden versions of files Long: `This command removes any old hidden versions of files
on a versions enabled bucket. on a versions enabled bucket.
Note that you can use --interactive/-i or --dry-run with this command to see what Note that you can use --interactive/-i or --dry-run with this command to see
it would do. what it would do.
Usage Examples: Usage example:
` + "```console" + ` ` + "```console" + `
rclone backend cleanup-hidden s3:bucket/path/to/dir rclone backend cleanup-hidden s3:bucket/path/to/dir
` + "```" + ` ` + "```",
`,
}, { }, {
Name: "versioning", Name: "versioning",
Short: "Set/get versioning support for a bucket.", Short: "Set/get versioning support for a bucket.",
@@ -3085,7 +3084,7 @@ rclone backend cleanup-hidden s3:bucket/path/to/dir
passed and then returns the current versioning status for the bucket passed and then returns the current versioning status for the bucket
supplied. supplied.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend versioning s3:bucket # read status only rclone backend versioning s3:bucket # read status only
@@ -3093,16 +3092,15 @@ rclone backend versioning s3:bucket Enabled
rclone backend versioning s3:bucket Suspended rclone backend versioning s3:bucket Suspended
` + "```" + ` ` + "```" + `
It may return "Enabled", "Suspended" or "Unversioned". Note that once versioning It may return "Enabled", "Suspended" or "Unversioned". Note that once
has been enabled the status can't be set back to "Unversioned". versioning has been enabled the status can't be set back to "Unversioned".`,
`,
}, { }, {
Name: "set", Name: "set",
Short: "Set command for updating the config parameters.", Short: "Set command for updating the config parameters.",
Long: `This set command can be used to update the config parameters Long: `This set command can be used to update the config parameters
for a running s3 backend. for a running s3 backend.
Usage Examples: Usage examples:
` + "```console" + ` ` + "```console" + `
rclone backend set s3: [-o opt_name=opt_value] [-o opt_name2=opt_value2] rclone backend set s3: [-o opt_name=opt_value] [-o opt_name2=opt_value2]
@@ -3116,8 +3114,7 @@ This rebuilds the connection to the s3 backend when it is called with
the new parameters. Only new parameters need be passed as the values the new parameters. Only new parameters need be passed as the values
will default to those currently in use. will default to those currently in use.
It doesn't return anything. It doesn't return anything.`,
`,
}} }}
// Command the backend to run a named command // Command the backend to run a named command