Storage: Revisions: RestoreRevision
RestoreRevision
Restores a certain revision of a file.
When the original file still exists, a revision is created before the file is overwritten with the specified revision.
When NewPath is specified and a file exists on the path the behavior depends on
OverwriteFile:
- OverwriteFile = true: a revision of the existing file is created and the file is
overwritten with the revision of the specified file.
- OverwriteFile = false: status code 4028 is returned; no revisions are created or restored.
Authentication Methods
- With a username and password
| Input Parameter | Type | Description |
|---|---|---|
| Token* | String | Security token |
| FileserverName* | String | Vault NMSA |
| VersionID* | String | VersionID |
| Path* | String | Path: folder where the revision is located |
| NewPath | String | The path where to restore the file to |
| OverwriteFile | Boolean | If a file already exists on NewPath it will be overwritten, otherwise a status code will be returned. |
| Output Parameter | Type | Description |
|---|---|---|
| Success | Status | Returns status code |
EXAMPLES
curl -v 'https://storage.example.com/storage/api.php?Token=ms28lbbsql627i3ftmoq2j00q2&FileserverName=nmsa98798798798&Task=RestoreRevision&Path=/mydirectory&VersionID=14d939f2-6e25-4704-ac04-92faa01941c9&FileName=myfile.txt'
With NewPath:
curl -v 'https://storage.example.com/storage/api.php?Token=ms28lbbsql627i3ftmoq2j00q2&FileserverName=nmsa98798798798&Task=RestoreRevision&Path=/mydirectory&VersionID=14d939f2-6e25-4704-ac04-92faa01941c9&FileName=myfile.txt&NewPath=/myrestoredfiles/&OverwriteFile=true'
RESPONSE
<Response>
<Status>1</Status>
<Message></Message>
</Response>