Use the get-remote-storage-settings operation to retrieve settings of a remote backups FTP storage.
A request XML packet retrieving remote storage settings includes the get-remote-storage-settings operation node:
<packet>
<backup-manager>
<get-remote-storage-settings>
...
</get-remote-storage-settings>
</backup-manager>
</packet>
The get-remote-storage-settings node is presented by type BackupGetRemoteStorageSettingsInput (backup.xsd
), and its graphical representation is as follows:
Note: If you do not define a target Plesk user, the operation will use packet sender identifier.
Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.
The get-remote-storage-settings node of the output XML packet is presented by type BackupGetRemoteStorageSettingsOutput (backup.xsd
) and structured as follows:
common.xsd
).backup.xsd
). For details on the node, refer to the Remote Storage Settings section.
This request packet retrieves remote storage settings for the customer account with ID 17.
<packet>
<backup-manager>
<get-remote-storage-settings>
<customer-id>17</customer-id>
<protocol>ftp</protocol>
</get-remote-storage-settings>
</backup-manager>
</packet>
Response:
<packet version="1.6.7.0">
<backup-manager>
<get-remote-storage-settings>
<result>
<status>ok</status>
<settings>
<protocol>ftp</protocol>
<host>ftp.example.com</host>
<port>113</port>
<directory>/backups/</protocol>
<login>myftplogin</login>
<password>myftppassword</password>
<passive-mode>false</passive-mode>
</settings>
</result>
</get-remote-storage-settings>
</backup-manager>
</packet>
If the settings haven't been specified, the response from the server is as follows:
<packet version="1.6.7.0">
<backup-manager>
<get-remote-storage-settings>
<result>
<status>ok</status>
<settings>
<protocol>ftp</protocol>
<host>false</host>
<port>21</port>
<directory>false</directory>
<login>false</login>
<password>false</password>
<passive-mode>false</passive-mode>
</settings>
</result>
</get-remote-storage-settings>
</backup-manager>
</packet>
A negative response from the server can look as follows:
<packet version="1.6.7.0">
<backup-manager>
<get-remote-storage-settings>
<result>
<status>error</status>
<errcode>1013</errcode>
<errtext>client does not exist</errtext>
</result>
</get-remote-storage-settings>
</backup-manager>
</packet>