Related links
Developer Resources
Upload
Upload your mission critical data securely to IDrive EVS storage with superior performance using this API.
Quick links
Syntax:
idevsutil --xml-output --password-file=<account password> --pvt-key=<key file path> --files-from=<path of filelist file> / <username>@<server address>::ibackup/
- --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.
- --password-file=PATH_OF_PSWD_FILE
Reads account password from the specified file. Alternately, you can directly set the password using --password-file=<account password>
- --files-from=PATH_OF_FILE_LIST_FILE
Reads list of file(s) / folder(s) that you wish to upload to 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.
Code:
idevsutil --xml-output --password-file="MyPassword" --pvt-key=enc_key --files-from=filelist / john@<server address>::ibackup/
- Full and Incremental upload
-
It transfers only modified portions after full initial data upload. Incremental data upload is a default feature.
Only modified portions of the file will be transferred during incremental upload. It uses the advanced patching technology to determine the changed data at source and applies only modified blocks of the changed files, on to the data that has been uploaded. All the incremental copies will be retained as versions*.
Note: To view the data upload type, such as Full upload, Incremental upload or the file is already present in server (file in sync); use --type parameter / switch along with the upload code
Example:
idevsutil --xml-output --password-file="MyPassword" --pvt-key=enc_key --type --files-from=filelist / john@<server address>::ibackup/
- ‘Mirror’ and ‘Relative’ path upload
-
Mirror Path:
This replicates the file / folder hierarchy present on the local computer to your
IDrive account. This is the default feature.
Relative Path:
This will not replicate the folder hierarchy of the file as it exists on your local computer but instead would just upload the file to a corresponding folder of your choice on your IDrive account.
Enable the ‘Relative’ path upload by using the '--no-mirror' parameter / switch.
Following is the sample code used for the upload of file(s) / folder(s) from the path ‘C:\DATA\DOC’ to “Documents” folder on your IDrive account.
Code:
idevsutil --xml-output --password-file="MyPassword" –-no-mirror --pvt-key=enc_key --files-from=filelist /C/DATA/DOC/ john@<server address>::ibackup/Documents/
filelist will have the file(s) / folder(s) path that you would like to upload from the location C:\DATA\DOC;
For Instance: content of the filelist file is as follows:
- /office_inventory.doc
- /tax_details.xls
- /DATE/daily_status.doc
- Multiple computers data upload
-
With this feature, data from multiple computers can be uploaded to your account. Data is uploaded to a folder with the same name or a user specific name to prevent data overlap.
To enable this feature, use '--mpc=NAME' parameter / switch.
a. To create a folder by default with name as that of your computer name and to upload all the file(s) / folder(s) into it.
Code:
idevsutil --xml-output --password-file="MyPassword" --mpc=0 --pvt-key=enc_key --files-from=filelist / john@<server address>::ibackup/
b. To create a custom folder name of your choice and to upload all the file(s) / folder(s) to the same.
Syntax:
idevsutil --xml-output --password-file=<account password> --mpc=<provide a name of your choice> --pvt-key=enc_key --files-from=filelist / <username>@<server address>::ibackup/
Code:
idevsutil --xml-output --password-file="MyPassword" --mpc=’MY COMP’ --pvt-key=enc_key --files-from=filelist / john@<server address>::ibackup/
- Throttle bandwidth usage for upload
-
The Bandwidth Throttle option allows you to adjust the percentage of Internet bandwidth to be used by the IDrive EVS application. It effectively divides the bandwidth between various Internet-based applications to help maintain their efficiency.
By default, the percentage is set to 100 and can be adjusted as required.
- Pause / Resume Upload
-
You can Pause and Resume the upload operation when it is in progress.
- Code / Output management
-
This section explains about the sample code execution and the output generated during the upload operation.
Content of filelist file:
- /C/Images/
- /C/Archive.zip
To upload “Images” and “Archive.zip” folder from “C” drive.
Code:
idevsutil --xml-output --password-file="MyPassword" --pvt-key=enc_key --files-from=filelist / john@<server address>::ibackup/
The above-mentioned code can be executed using
any programming language across any platform (Windows,
Mac and Linux).
Output:
Sample XML output:
<item size="25399" tottrf_sz="25399" tot_sz="86437" per="100%" rate_trf="0.12kB/s" fname="C/Images/Image1.jpg"/>
<item size="34399" tottrf_sz="34399" tot_sz="98437" per="100%" rate_trf="0.21kB/s" fname="C/Archive.zip"/>
Description:
The following details are displayed during upload operation:
- item size
Size of the particular file
- tottrf_sz
Amount of data transferred with respect to the total upload set size
- tot_sz
Total size of your upload set
- per
Percentage of data transferred for a particular file
- rate_trf
Rate of data transfer
- fname
File name
You can make use of I / O redirection methods for redirecting IDrive EVS command line utility (idevsutil) output.
* The recent 30 versions of a file are available for download.