Command line utility (idevsutil) APIs

Development made easy: IDrive EVS APIs

Time-line Download

IDrive EVS provides you with the ability to download data as a unit with a time value reference. In order to group the file(s) / folder(s) with the time value reference, name the complete upload session with a specific time value using --timeid=DATE-TIME parameter / switch during data upload.

Use the download command to download after listing all file(s) / folder(s) for a particular time value reference. Refer below section to set and list time value reference.

1. Providing time value reference during data upload for the file(s) / folder(s) using --timeid parameter / switch.

Use --timeid=DATE-TIME to specify the time value reference to make the data as a unit for an upload session.
Syntax:
idevsutil --xml-output --password-file=<account password> --pvt-key=<key file path> --timeid=<DD-MM-YYYY HH:MM> --files-from=<path of filelist file> / <username>@<server address>::ibackup/
Code:
idevsutil --xml-output --password-file="MyPassword" --pvt-key=enc_key --timeid=<DD-MM-YYYY HH:MM> --files-from=filelist / john@<server address>::ibackup/

2. List all the stored time values.

Use --list-timeid parameter / switch to list all the stored time values.
Syntax:
idevsutil --xml-output --password-file=<account password> --list–timeid <username>@<server address>::ibackup/
Code:
idevsutil --xml-output --password-file="MyPassword" --list–timeid john@<server address>::ibackup/

3. Search all file(s) / folder(s) with the time value reference.

Use --timeid=DATE-TIME parameter / switch along with the search command to list all the file(s) / folder(s) with the time value reference
Syntax:
idevsutil --xml-output --password-file=<account password> --search --timeid=<DD-MM-YYYY HH:MM> <username>@<server address>::ibackup/
Code:
idevsutil --xml-output --password-file="MyPassword" --search --timeid=<DD-MM-YYYY HH:MM> john@<server address>::ibackup/

4. Download file(s) / folder(s) as a unit with a time value (the time value which is set during data upload) reference.

Use --timeid=DATE-TIME to specify the time value reference for downloading the data as a unit.
Syntax:
idevsutil --xml-output --password-file=<account password> --pvt-key=<key file path> --timeid=<DD-MM-YYYY HH:MM> --files-from=<path of filelist file> <username>@<server address>::ibackup/ /<download location on your computer>/
Code:
idevsutil --xml-output --password-file="MyPassword" --pvt-key=enc_key --timeid=<DD-MM-YYYY HH:MM> --files-from=filelist john@<server address>::ibackup/ /C/Download/


5. Manage time value session for file(s) / folder(s) during Delete, Rename, Moving file(s) / folder(s) to original location and Deleting the file(s) / folder(s) from Trash.

Use the --timeline parameter / switch in order to keep the time value session items in sync along with --delete-items, --rename, --moveto-original and --deletefrom-trash commands.

a. Delete


Use the --timeline parameter / switch in order to keep the time value session items in sync for delete operations.
Syntax:
idevsutil --xml-output --password-file=<account password> --timeline --delete-items --pvt-key=<key file path> --files-from=< path of filelist file > <username>@<server address>::ibackup/
Code:
idevsutil --xml-output --password-file="MyPassword" --timeline --delete-items --pvt-key=enc_key --files-from=filelist john@<server address>::ibackup

b. Rename

Use the --timeline parameter / switch in order to keep the time value session items in sync for rename operations.
Syntax:
idevsutil --xml-output --password-file=<account password> --timeline --rename --old-path=<file/folder path> --new-path=<file/folder path> --pvt-key=<key file path> <username>@<server address>::ibackup/
Code:
idevsutil --xml-output --password-file="MyPassword" --timeline --rename --old-path=/C/originalfile.doc --new-path=/C/newfile.doc --pvt-key=enc_key john@<server address>::ibackup/

c. Move files / folders to original location

Use the --timeline parameter / switch in order to keep the time value session items in sync for move to original operations
Syntax:
idevsutil --xml-output --password-file=<account password> --timeline --moveto-original --pvt-key=<key file path> --files-from=< path of filelist file > <username>@<server address>::ibackup/
Code:
idevsutil --xml-output --password-file="MyPassword" --timeline --moveto-original --pvt-key=enc_key --files-from=filelist john@<server address>::ibackup/

d. Delete the files / folders from Trash

Use the --timeline parameter / switch in order to keep the time value session items in sync for delete from Trash operations.
Syntax:
idevsutil --xml-output --password-file=<account password> --timeline --deletefrom-trash --pvt-key=<key file path> --files-from=< path of filelist file > <username>@<server address>::ibackup/
Code:
idevsutil --xml-output --password-file="MyPassword" --timeline --deletefrom-trash --pvt-key=enc_key --files-from=filelist john@<server address>::ibackup


Common parameter / switch details


  • --pvt-key=PATH_OF_PVT_KEY_FILE
    Reads private encryption key for AES 256-bit encryption for all data transfers. Private encryption key length can vary from minimum of 4 characters to maximum of 255 characters. If you opt for the default encryption key during your IDrive account sign up then the use of the private encryption key is not required.
  • --files-from=PATH_OF_FILE_LIST_FILE
    Reads list of file(s) / folder(s) that you wish to download from your IDrive account.
  • Username
    IDrive username. If you do not have a valid username, Sign up with IDrive.
  • Server address
    Use GetServerAddress API to retrieve the IDrive server address.

You can make use of I / O redirection methods for redirecting IDrive EVS command line utility (idevsutil) output.

Refer code repository for more details on usage / implementation.