The ippool-del-ip operation is used to remove IP addresses from the reseller’s IP pool.

Request Packet Structure

A request XML packet removing IP addresses from reseller’s IP pool includes the ippool-del-ip node:

<packet>
    <reseller>
        <ippool-del-ip>
            ...
        </ippool-del-ip>
    </reseller>
</packet>

The ippool-del-ip node is specified by ResellerIpPoolDelInput complex type (reseller.xsd). Its graphical representation is as follows:

image 60390

Note: The interactive schema navigator for all request packets is available here: http://plesk.github.io/api-schemas/1.6.9.1/agent_input.svg.

  • The reseller-id node is required. It specifies the ID of a reseller account from whose IP pool an IP address is to be removed. Data type: integer.
  • The ip-address node is required. It specifies an IP address which is to be removed from a reseller’s IP pool. Data type: ip_address (common.xsd).

Note: When creating request packets, put nodes and elements in the order they follow in the packet structure.

Response Packet Structure

The ippool-del-ip node of the response packet is structured as follows (data type ResellerIpPoolOperationOutput (reseller.xsd)):

image 60587

Note: The interactive schema navigator for all response packets is available here: http://plesk.github.io/api-schemas/1.6.9.1/agent_output.svg.

  • 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 ippool-del-ip operation. Data type: result_status (common.xsd). Allowed values: ok|error.
    • The errcode node is required if the ippool-del-ip operation fails. It returns the error code. Data type: unsignedInt.
    • The errtext node is required if the ippool-del-ip operation fails. It returns the error message. Data type: string.
    • The ip-address node is required if the operation succeeds. It returns the IP address added to the reseller’s IP pool. Data type: ip_address (common.xsd).
    • The reseller-id node is optional. It is not returned for this operation.

Samples

To remove IP address from a reseller’s IP pool, specify the packet as follows:

<packet>
    <reseller>
        <ippool-del-ip>
            <reseller-id>1234</reseller-id>
            <ip-address>192.0.2.111</ip-address>
        </ippool-del-ip>
    </reseller>
</packet>

Response:

<packet>
    <reseller>
        <ippool-del-ip>
            <result>
                <status>ok</status>
                <ip-address>192.0.2.111</ip-address>
            </result>
        </ippool-del-ip>
    </reseller>
</packet>