Database Manager - RestoreDatabase

Version: 7C

HC7 Build: 7.00.0012 and later

API Build: 1.00.0001 and later

Database Manager- RestoreDatabase  restores database from a specified filename. This web service call can be made as http://your-domain.com/HC7API/DatabaseManager.asmx?op=RestoreDatabase.

Input Parameters

• HostUserName

• HostPassword

• OwnerName

• DatabaseName - name of the database you want to restore

• BackupFilePath - physical path of the backup file

• OptionalParam

• Language
   

Output Parameters

       N/A

Sample Optional Parameters

<Parameters>

<Parameter Name = "Language">French</Parameter>

</Parameters>

Sample SOAP Request

POST /HC7API/DatabaseManager.asmx HTTP/1.1

Host: your-domain.com

Content-Type: text/xml; charset=utf-8

Content-Length: length

SOAPAction: "http://tempuri.org/RestoreDatabase"

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

  <soap:Body>

    <RestoreDatabase xmlns="http://tempuri.org/">

      <HostUserName>host</HostUserName>

      <HostPassword>host123</HostPassword>

      <OwnerName>david</OwnerName>

      <DatabaseName>MyDatabase</DatabaseName>

      <BackupFilePath>C:\Webspace\david\john\MyDomain.com\db\MyDatabase<\BackupFilePath>

      <OptionalParam>xml</OptionalParam>

    </RestoreDatabase>

  </soap:Body>

</soap:Envelope>

Sample HTTP Request

POST /HC7API/DatabaseManager.asmx/RestoreDatabase HTTP/1.1

Host: your-domain.com

Content-Type: application/x-www-form-urlencoded

Content-Length: length

HostUserName=host&HostPassword=host123&OwnerName=david&DatabaseName=MyDatabase&

BackupFilePath=C:/Webspace/david/john/MyDomain.com/db/MyDatabase&OptionalParam=xml

Sample C# Code

public DatabaseManager.Response RestoreDatabase(string strHostUserName, string strHostPassword, string strOwnerName, string strDatabaseName, string strBackupFilePath)

{

         try

         {

                    DatabaseManager.DatabaseManager oDatabase = new DatabaseManager.DatabaseManager();

                    DatabaseManager.Response oResponse = new DatabaseManager.Response();

                    oResponse = oDatabase.RestoreDatabase(strHostUserName, strHostPassword, strOwnerName,

                    strDatabaseName, strBackupFilePath, null);

         }

         catch

         {

         }

         return oResponse;

}

Sample Response

<Response>

    <Method>RestoreDatabase</Method>

    <Status>true</Status>

    <ErrorCode>73100061</ErrorCode>

    <ErrorDescription>Database restore is a lengthy task; it is queued to be performed later.</ErrorDescription>           

    <Result/>

</Response>