Chapter 4. Plesk RPC API Protocol
In the further given schemas, used for
forming packets with data for various operations, the schemas with the INPUT
term describe packets with the data received at the input by Plesk.
Correspondingly, the schemas with the OUTPUT term describe
packets with the data returned by Plesk to an external application
after the action of the handler that was called in by an incoming INPUT
packet.
Section 4.1 Performing
Operations on Client Accounts
These operations allow for managing
client data, i.e. creating new client accounts, editing client account
properties, receiving info on certain client accounts.
Client input:
| diagram |
 |
| properties |
|
| children |
client |
| attributes |
| Name | Type | Use | Default | Fixed | Annotation | | version | string | required | | | |
|
| annotation |
| documentation | Root node for any input |
|
| diagram |
 |
| properties |
|
| children |
filter dataset |
| annotation |
| documentation | Get client accounts data from server |
|
| diagram |
 |
| type |
filterType |
| properties |
|
| children |
id |
| annotation |
| documentation | Filter client accounts to be refreshed |
|
| diagram |
 |
| properties |
|
| children |
filter |
| annotation |
| documentation | Delete client account(s) from server |
|
| diagram |
 |
| type |
filterType |
| properties |
|
| children |
id |
| annotation |
| documentation | Filter client accounts to be deleted |
|
| diagram |
 |
| properties |
|
| children |
filter values |
| annotation |
| documentation | Set client account properties |
|
| diagram |
 |
| type |
filterType |
| properties |
|
| children |
id |
| annotation |
| documentation | Filter client accounts to be refreshed |
|
| diagram |
 |
| properties |
|
| children |
filter |
| annotation |
| documentation | Show the list of buttons from the client page |
|
| diagram |
 |
| type |
filterType |
| properties |
|
| children |
id |
| annotation |
| documentation | Filter client accounts to be listed |
|
| diagram |
 |
| children |
id |
| used by |
|
| annotation |
| documentation | Filter the list of client acounts |
|
| diagram |
 |
| type |
id_type |
| properties |
|
| facets |
|
| annotation |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 60 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 60 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 20 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 5 | | maxLength | 14 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
objectStatus |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| annotation |
| documentation | 0:ACTIVE, 16:DISABLED_BY ADMIN, 4:UNDER BACKUP/RESTORE, 256: EXPIRED |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 30 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 30 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 255 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 255 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 50 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 50 | | whiteSpace | collapse |
|
| annotation |
| documentation | Should be filled in for US |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 10 | | whiteSpace | collapse |
|
| annotation |
| documentation | Should be filled in for US |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 2 | | maxLength | 2 | | whiteSpace | collapse |
|
| annotation |
| documentation | Example: US |
|
| diagram |
 |
| type |
string |
| properties |
| isRef | 0 | | content | simple | | default | en |
|
| facets |
|
| diagram |
 |
| type |
date |
| properties |
|
| facets |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 60 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 60 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 20 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
objectStatus |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 30 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 30 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 255 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 255 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 50 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 50 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 10 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 2 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
string |
| properties |
| isRef | 0 | | content | simple | | default | en |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| annotation |
| documentation | Plesk >= 7.1 |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| annotation |
| documentation | Plesk >= 7.1 |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 60 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 60 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 20 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 5 | | maxLength | 14 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
objectStatus |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 30 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 30 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 255 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 255 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 50 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 50 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 10 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 2 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
string |
| properties |
| isRef | 0 | | content | simple | | default | en |
|
| facets |
|
| diagram |
 |
| properties |
|
| annotation |
| documentation | Client general info |
|
| diagram |
 |
| properties |
|
| annotation |
| documentation | Client statistics |
|
| diagram |
 |
| properties |
|
| annotation |
| documentation | Client permissions |
|
| diagram |
 |
| properties |
|
| annotation |
| documentation | Client limits |
|
| diagram |
 |
| properties |
|
| annotation |
| documentation | IP pool configuration |
|
| diagram |
 |
| children |
client_id ip_address |
| used by |
|
| annotation |
| documentation | Data to operate the client IP pool |
|
| diagram |
 |
| type |
id_type |
| properties |
|
| facets |
|
| diagram |
 |
| type |
ip_address |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 15 | | whiteSpace | collapse |
|
| diagram |
 |
| children |
ip_address |
| used by |
|
| annotation |
| documentation | Client IP pool data |
|
| diagram |
 |
| type |
ip_address |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 15 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
ip_address |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 15 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
id_type |
| properties |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
size |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| diagram |
 |
| type |
size |
| properties |
|
| facets |
|
| annotation |
| documentation | Monthly traffic in bytes |
|
| diagram |
 |
| type |
size |
| properties |
|
| facets |
|
| annotation |
| documentation | Total traffic for prev.day (in bytes) |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| annotation |
| documentation | Button string ID |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| whiteSpace | collapse | | enumeration | link_button | | enumeration | comm_button |
|
| annotation |
| documentation | Button type |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| annotation |
| documentation | Button name |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| annotation |
| documentation | Button name (string ID for localization) |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| annotation |
| documentation | Button owner group name |
|
| diagram |
 |
| type |
string |
| properties |
|
| facets |
|
| annotation |
| documentation | Button owner group name (string ID for localization) |
|
| diagram |
 |
| type |
urlType |
| properties |
|
| facets |
| maxLength | 255 | | whiteSpace | collapse |
|
| annotation |
| documentation | Button linked to |
|
| diagram |
 |
| type |
text |
| properties |
|
| facets |
|
| annotation |
| documentation | JavaScript code associated with the button onClick event handle |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| annotation |
| documentation | Button enabled flag |
|
| diagram |
 |
| type |
boolean |
| properties |
|
| facets |
|
| annotation |
| documentation | New window flag. It should be specified in protocol 1.3.1.7 and higher |
|
| diagram |
 |
| type |
int |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| annotation |
| documentation | Button tabulation index |
|
| type |
restriction of string |
| facets |
| whiteSpace | collapse | | enumeration | free | | enumeration | reserved | | enumeration | assigned |
|
| annotation |
| documentation | IP address usage status in Expand DB |
|
| type |
restriction of string |
| facets |
| minLength | 1 | | maxLength | 255 | | whiteSpace | collapse |
|
| annotation |
| documentation | URL, only symbolic name, not an IP |
|
| type |
string |
| facets |
|
| annotation |
| documentation | Garbage Output, for debug |
|
| type |
restriction of string |
| facets |
| whiteSpace | collapse | | enumeration | shared | | enumeration | exclusive |
|
| annotation |
| documentation | IP address usage status in Expand DB |
|
| type |
restriction of string |
| facets |
| minLength | 1 | | maxLength | 200 | | whiteSpace | collapse |
|
| annotation |
| documentation | Server Network Interface name |
|
| type |
int |
| used by |
|
| facets |
|
| annotation |
| documentation | Plesk client and domain status.
Bit mask with bit flags:
0 - object is active
4 - object is under backup/restore
16 - object is disabled by Administrator
64 - object is disabled by Client
256 - object expired
Only 0, 16 and 64 flags are available for setting |
|
| type |
restriction of string |
| facets |
| whiteSpace | collapse | | enumeration | Windows | | enumeration | RedHat |
|
| annotation |
| documentation | Operation System, see enumerations for details |
|
| diagram |
 |
| type |
result_status |
| properties |
|
| facets |
| enumeration | ok | | enumeration | error |
|
| annotation |
| documentation | Result status (ok/error) |
|
| diagram |
 |
| type |
unsignedInt |
| properties |
|
| facets |
|
| annotation |
| documentation | Error code if error occurred |
|
| diagram |
 |
| type |
xs:string |
| properties |
|
| annotation |
| documentation | Error message if error occurred |
|
| type |
restriction of xs:base64Binary |
| facets |
|
| type |
restriction of xs:boolean |
| used by |
|
| facets |
|
| type |
restriction of xs:date |
| used by |
|
| facets |
|
| type |
restriction of xs:dateTime |
| facets |
|
| type |
restriction of xs:double |
| facets |
|
| type |
restriction of string |
| facets |
| minLength | 3 | | maxLength | 255 | | whiteSpace | collapse | | pattern | [\-\p{L}\p{N}\.]*@([\p{L}\p{N}][\-\p{L}\p{N}]*\.)*[\p{L}][\-\p{L}\p{N}]*\.? |
|
| annotation |
| documentation | Any e-mail address |
|
| type |
restriction of xs:positiveInteger |
| used by |
|
| facets |
|
| annotation |
|
| type |
restriction of xs:integer |
| used by |
|
| facets |
|
| type |
restriction of xs:string |
| used by |
|
| facets |
| minLength | 1 | | maxLength | 15 | | whiteSpace | collapse |
|
| type |
restriction of string |
| facets |
| minLength | 4 | | maxLength | 64 | | whiteSpace | collapse |
|
| annotation |
| documentation | Typical password |
|
| type |
restriction of xs:string |
| used by |
|
| facets |
| enumeration | ok | | enumeration | error |
|
| annotation |
| documentation | Result status |
|
| type |
restriction of xs:short |
| facets |
|
| type |
restriction of xs:unsignedLong |
| used by |
|
| facets |
|
| type |
restriction of xs:string |
| used by |
|
| facets |
|
| type |
restriction of xs:string |
| used by |
|
| facets |
|
| type |
restriction of xs:unsignedInt |
| used by |
|
| facets |
|
| type |
restriction of xs:unsignedShort |
| facets |
|
| type |
restriction of string |
| used by |
|
| facets |
| maxLength | 255 | | whiteSpace | collapse |
|
| annotation |
|
| type |
restriction of string |
| facets |
| maxLength | 10 | | whiteSpace | collapse |
|
| diagram |
 |
| properties |
|
| children |
client system output |
| attributes |
| Name | Type | Use | Default | Fixed | Annotation | | version | string | required | | | |
|
| annotation |
| documentation | Root node for any input |
|
| diagram |
 |
| properties |
|
| children |
result |
| annotation |
| documentation | Add a new client account |
|
| diagram |
 |
| type |
id_type |
| properties |
|
| facets |
|
| annotation |
| documentation | New client ID upon success |
|
| diagram |
 |
| properties |
|
| children |
result |
| annotation |
| documentation | "Get" operation result |
|
| diagram |
 |
| properties |
|
| children |
result |
| annotation |
| documentation | "Delete" operation result |
|
| diagram |
 |
| properties |
|
| children |
result |
| annotation |
| documentation | Modify client |
|
| diagram |
 |
| properties |
|
| children |
result |
| annotation |
| documentation | The result of adding the IP address(es) to the client's IP pool |
|
| diagram |
 |
| properties |
|
| children |
result |
| annotation |
| documentation | The result of deleting the IP address(es) from the client's IP pool |
|
| diagram |
 |
| properties |
|
| children |
result |
| annotation |
| documentation | The result of showing the list of the Client page buttons |
|
| diagram |
 |
| type |
id_type |
| properties |
|
| facets |
|
| annotation |
|
| diagram |
 |
| type |
garbageOutput |
| properties |
|
| facets |
|
| annotation |
| documentation | Debug garbage |
|
| diagram |
 |
| type |
id_type |
| properties |
|
| facets |
|
| annotation |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 60 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 60 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 1 | | maxLength | 20 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 5 | | maxLength | 14 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
objectStatus |
| properties |
| isRef | 0 | | content | simple | | default | 0 |
|
| facets |
|
| annotation |
| documentation | 0:ACTIVE, 16:DISABLED_BY ADMIN, 4:UNDER BACKUP/RESTORE, 256: EXPIRED |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 30 | | whiteSpace | collapse |
|
| diagram |
 |
| type |
restriction of string |
| properties |
|
| facets |
| minLength | 0 | | maxLength | 30 | | whiteSpace | collapse |
|