mirror of
https://github.com/rclone/rclone.git
synced 2026-10-09 14:39:28 -04:00
onedrive: update docs for versions, links and time precision on personal accounts
Testing against OneDrive personal (free) and OneDrive for Business shows - personal accounts now create versions on setting the modification time and can delete them, so --onedrive-no-versions and rclone cleanup work there - --onedrive-link-password works on OneDrive for Business - personal free accounts can't set a link password or --expire - --onedrive-link-type embed only works on OneDrive personal - personal accounts store times with 1s precision, not mS See #9917
This commit is contained in:
1 parent
7a2d7c766d
commit
ff02636fe4
3 files changed
+12
-18
No files matched your search
@@ -20,7 +20,7 @@ import (
|
||||
const (
|
||||
dirMimeType = "inode/directory"
|
||||
timeFormatIn = time.RFC3339
|
||||
timeFormatOut = "2006-01-02T15:04:05.999Z" // mS for OneDrive Personal, otherwise only S
|
||||
timeFormatOut = "2006-01-02T15:04:05.999Z" // keeps mS if present, though OneDrive only stores S
|
||||
)
|
||||
|
||||
// system metadata keys which this backend owns
|
||||
@@ -32,17 +32,17 @@ var systemMetadataInfo = map[string]fs.MetadataHelp{
|
||||
ReadOnly: true,
|
||||
},
|
||||
"mtime": {
|
||||
Help: "Time of last modification with S accuracy (mS for OneDrive Personal).",
|
||||
Help: "Time of last modification with S accuracy.",
|
||||
Type: "RFC 3339",
|
||||
Example: "2006-01-02T15:04:05Z",
|
||||
},
|
||||
"btime": {
|
||||
Help: "Time of file birth (creation) with S accuracy (mS for OneDrive Personal).",
|
||||
Help: "Time of file birth (creation) with S accuracy.",
|
||||
Type: "RFC 3339",
|
||||
Example: "2006-01-02T15:04:05Z",
|
||||
},
|
||||
"utime": {
|
||||
Help: "Time of upload with S accuracy (mS for OneDrive Personal).",
|
||||
Help: "Time of upload with S accuracy.",
|
||||
Type: "RFC 3339",
|
||||
Example: "2006-01-02T15:04:05Z",
|
||||
ReadOnly: true,
|
||||
@@ -113,7 +113,7 @@ var systemMetadataInfo = map[string]fs.MetadataHelp{
|
||||
ReadOnly: true,
|
||||
},
|
||||
"shared-time": {
|
||||
Help: "Time when the item was shared, with S accuracy (mS for OneDrive Personal).",
|
||||
Help: "Time when the item was shared, with S accuracy.",
|
||||
Type: "RFC 3339",
|
||||
Example: "2006-01-02T15:04:05Z",
|
||||
ReadOnly: true,
|
||||
|
||||
@@ -294,16 +294,13 @@ cases, rclone will fall back to normal copy (which will be slightly slower).`,
|
||||
Default: false,
|
||||
Help: `Remove all versions on modifying operations.
|
||||
|
||||
Onedrive for business creates versions when rclone uploads new files
|
||||
Onedrive creates versions when rclone uploads new files
|
||||
overwriting an existing one and when it sets the modification time.
|
||||
|
||||
These versions take up space out of the quota.
|
||||
|
||||
This flag checks for versions after file upload and setting
|
||||
modification time and removes all but the last version.
|
||||
|
||||
**NB** Onedrive personal can't currently delete versions so don't use
|
||||
this flag there.
|
||||
`,
|
||||
Advanced: true,
|
||||
}, {
|
||||
@@ -342,14 +339,18 @@ This works with OneDrive for Business, SharePoint document libraries, and OneDri
|
||||
Help: "Creates a read-write link to the item.",
|
||||
}, {
|
||||
Value: "embed",
|
||||
Help: "Creates an embeddable link to the item.",
|
||||
Help: "Creates an embeddable link to the item.\nOnly available in OneDrive personal.",
|
||||
}},
|
||||
}, {
|
||||
Name: "link_password",
|
||||
Default: "",
|
||||
Help: `Set the password for links created by the link command.
|
||||
|
||||
At the time of writing this only works with OneDrive personal paid accounts.
|
||||
At the time of writing this works with OneDrive for Business and
|
||||
OneDrive personal paid accounts.
|
||||
|
||||
OneDrive personal free accounts can't set a password or an expiry time
|
||||
(with --expire) on links.
|
||||
`,
|
||||
Advanced: true,
|
||||
Sensitive: true,
|
||||
|
||||
@@ -1169,11 +1169,6 @@ Or you can set the `no_versions` parameter to `true` and rclone will
|
||||
remove versions after operations which create new versions. This takes
|
||||
extra transactions so only enable it if you need it.
|
||||
|
||||
**Note** At the time of writing Onedrive Personal creates versions
|
||||
(but not for setting the modification time) but the API for removing
|
||||
them returns "API not found" so cleanup and `no_versions` should not
|
||||
be used on Onedrive Personal.
|
||||
|
||||
### Disabling versioning
|
||||
|
||||
Starting October 2018, users will no longer be able to
|
||||
@@ -1228,8 +1223,6 @@ rclone cleanup --interactive remote:path/subdir # interactively remove all old v
|
||||
rclone cleanup remote:path/subdir # unconditionally remove all old version for path/subdir
|
||||
```
|
||||
|
||||
**NB** Onedrive personal can't currently delete versions
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Excessive throttling or blocked on SharePoint
|
||||
|
||||
Reference in new issue
Block a user