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
- Using Kerberos
| Input Parameter |
Type |
Description |
| Token* |
String |
Security token |
| FileserverName* |
String |
Vault NMSA |
| Date* |
UnixTime |
Revision Date |
| 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 |
CURL EXAMPLE
curl -v 'https://storage.example.com/storage/api.php?Token=ms28lbbsql627i3ftmoq2j00q2&FileserverName=nmsa98798798798&Task=RestoreRevision&Path=/mydirectory&Date=1266481211.337534&FileName=myfile.txt'
With NewPath:
curl -v 'https://storage.example.com/storage/api.php?Token=ms28lbbsql627i3ftmoq2j00q2&FileserverName=nmsa98798798798&Task=RestoreRevision&Path=/mydirectory&Date=1266481211.337534&FileName=myfile.txt&NewPath=/myrestoredfiles/&OverwriteFile=true'
RESPONSE
<Response>
<Status>1</Status>
<Message></Message>
</Response>