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


  1. With a username and password
  2. 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>