Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

REST API Method: POST /rest/system?action=restore

This action restores the SBC's backup configuration file.

Info

If the action fails, a set of Application Status Error Codes will be returned representing all configuration validation errors found in the file and detected by the SBC. If the action succeeds, the SBC will automatically reboot.

URL:

https://192.168.0.111/rest/system?action=restore

HTTP Method

POST

Requires Authentication:

true

Noprint
Panel
bgColortransparent
titleBGColor#DDD
title[system - REST API Methods|Resource - system]

Page Tree
root@parent



Parameters

Parameter Name Required Service Affecting Data Type Default Value Possible Values Description
FilenameYesYesstringnone255 - Max LengthIdentifies the name of the backup configuration file being restored into the SBC. File needs to be of extension .tar or .tar.gz
PassphraseNoYesstringnone128 - Max LengthIdentifies the passphrase to be used for the password decryption operation. If the password decryption fails, all the passwords in the configuraion will be set to NULL, and the user should reset all the passwords manually. The password decryption fails in two circumstances 1) when the wrong passphrase used for the restore operation. 2) When the configuration was backed up with the passphrase and the same configuration is restored into a node without the passphrase.
ReplacePasswordsNoYesEnum1Possible values:
  • 0 - btFalse
  • 1 - btTrue
Specifies whether username and passwords from the backup being restored should replace the current ones.