Removing Reseller Accounts
The del operation is used to remove reseller accounts and all their settings from Plesk database.
Request Packet Structure
A request XML packet removing a reseller account from Plesk database includes the del operation node:
<packet version="1.6.0.0">
<reseller>
<del>
...
</del>
</reseller>
</packet>
The del node is presented by the ResellerDelInput type (reseller.xsd
). Its graphical representation is as follows:
-
filter, required.
It specifies the filtering rule. Data type: ResellerSelectionFilter (
reseller.xsd
). For more information on filters, refer to the Available Filters section.
Response Packet Structure
The del node of the response packet is structured as follows:
- The result node is required. It wraps the response retrieved from the server. Data type: resultFilterType (
common.xsd
).- The status node is required. It specifies the execution status of the del operation. Data type: result_status (
common.xsd
). Allowed values:ok|error
. - The errcode node is required if the del operation fails. It returns the error code. Data type: unsignedInt.
- The errtext node is required if the del operation fails. It returns the error message. Data type: string.
- The filter-id node is required. It returns the parameter by which the reseller account was filtered in the request packet. Data type: anySimple.
- The id node is required if the operation succeeds, or if the results are filtered by ID. It returns ID of the removed reseller account. Data type: id_type (
common.xsd
).
- The status node is required. It specifies the execution status of the del operation. Data type: result_status (
Samples
Removing a single reseller account
To remove a reseller account, specify its ID or login name:
<packet version="1.6.0.0">
<reseller>
<del>
<filter>
<id>1324</id>
</filter>
</del>
</reseller>
</packet>
Response:
<packet version="1.6.0.0">
<reseller>
<del>
<result>
<status>ok</status>
<filter-id>2</filter-id>
<id>2</id>
</result>
</del>
</reseller>
</packet>
Removing multiple reseller accounts
To remove multiple reseller accounts, add either reseller IDs or login names to the filtering rule:
<packet version="1.6.0.0">
<reseller>
<del>
<filter>
<id>1324</id>
<id>1325</id>
</filter>
</del>
</reseller>
</packet>
Response:
<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.0.0">
<reseller>
<del>
<result>
<status>ok</status>
<filter-id>2</filter-id>
<id>1</id>
</result>
<result>
<status>ok</status>
<filter-id>2</filter-id>
<id>2</id>
</result>
</del>
</reseller>
</packet>
Removing all reseller accounts
To remove all reseller accounts, use the following packet:
<packet version="1.6.0.0">
<reseller>
<del>
<filter>
<all/>
</filter>
</del>
</reseller>
</packet>
Response:
<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.0.0">
<reseller>
<del>
<result>
<status>ok</status>
<filter-id>3</filter-id>
<id>3</id>
</result>
<result>
<status>ok</status>
<filter-id>4</filter-id>
<id>4</id>
</result>
</del>
</reseller>
</packet>