Support

Documentation

stepBackup

Continues a backup job started with startBackup

Request Data expected

The backupid field is recommended since API 335 and mandatory since API 340. If you do not pass the backupid the backup will most likely fail.

tag

String. Optional. Default = json. Do not use this option! This is reserved for future use.

backupid

String. MANDATORY. The unique identifier of this backup, as returned by the previous call to startBackup or stepBackup.

Response Data returned

HasRun

Boolean. When true, more steps are required to backup the site (unless Error is not empty). When false, the backup has just finished.

Domain

String. The backup domain. It can be one of "init', 'installer', 'db', 'pack', 'finalization'. It tells you which major step the backup is in, i.e. 'db' for database backup.

Step

String. Free text describing the last operation in the current domain, e.g. the name of the last folder backed up. You should only use it for verbose progress display.

Substep

String. Free text, giving more detail about the Step. You should only use it for verbose progress display.

Error

String. The last error occurred. If this is not an empty string or null, you can assume that the backup has failed, irrespectively of the HasRun value.

Warnings

Array of Strings. The warnings produced during the last step. You'd better display them to the user.

Archive

String. The name of the backup archive. You will only get this in one of the responses of startBackup or stepBackup, when the archive is first created. In all other responses it will be empty. Only use the non-empty response. Since API 340.

Progress

Integer. The percentage of the backup process completion (0-100). Since API 340.

backupid

String. The unique identifier of this backup. You need to pass this in all subsequent calls to stepBackup. Since API 340.

sleepTime

Integer. How many milliseconds you should wait before you run the next stepBackup. Since API 340.

stepNumber

Integer. The sequential number of this step. Step numbers returned by stepBackup must be sequentially numbered, monotonically increasing. Anything else indicates a misbehaving server / broken backup. Since API 340.

stepState

String. The run state of the engine. It can be one of error, init, prepared, running, postrun and finished. This is debugging information about the engine internals and you should not act upon it. Since API 340.