Use the del operation to remove the IP address from Plesk database. You cannot remove the IP of the computer (defined by network configuration), where Plesk server is located. You also cannot remove the IP address if one or more sites are hosted on this IP or forwarded from this IP.
Note: You cannot remove an IP address from IP pool of a reseller who shares this IP with Plesk customers.
A request XML packet removing the IP address from Plesk database includes the del operation node:
<packet>
<ip>
<del>
...
</del>
</ip>
</packet>
The del node graphical representation is as follows:
(ip_input.xsd).
common.xsd
).Remarks
You can remove multiple IP addresses in a single packet. Add as many ip_address operations as the number of IP addresses you want to remove.
<filter>
<ip_address>...</ip_address>
...
<ip_address>...</ip_address>
</filter>
The del node of the output XML packet is structured as follows:
common.xsd
).common.xsd
).This packet removers 192.0.2.1 IP address from Plesk database.
<packet>
<ip>
<del>
<filter>
<ip_address>192.0.2.1</ip_address>
</filter>
</del>
</ip>
</packet>
Response:
<packet>
<ip>
<set>
<result>
<status>ok</status>
<ip_address>192.0.2.1</ip_address>
</result>
</set>
</ip>
</packet>
This packet removes 192.0.2.10 and 192.0.2.12 IP addresses.
<packet>
<ip>
<del>
<filter>
<ip_address>192.0.2.10</ip_address>
<ip_address>192.0.2.12</ip_address>
</filter>
</del>
</ip>
</packet>
Response (if the first IP address was removed and the second IP address was not found):
<packet>
<ip>
<set>
<result>
<status>ok</status>
<ip_address>192.0.2.10</ip_address>
</result>
<result>
<status>error</status>
<errcode>1013</errcode>
<errcode>ip does not exist.</errcode>
<ip_address>192.0.2.12</ip_address>
</result>
</set>
</ip>
</packet>