Checking Status of Spam Filtering Service
Use the check operation to check if the Spam Filtering service is installed on the server and allowed by Plesk license.
Request Packet Structure
A request XML packet retrieving status of Spam Filtering service on the server includes the check operation node:
The check node graphical representation is as follows:
Response Packet Structure
The check node of the output XML packet is presented by type SpamFilterCheckOutputType (spamfilter.xsd
) and structured as follows:
- The result node is required. It wraps the response retrieved from the server. Data type: resultType (
common.xsd
). - The status node is required. It specifies if the Spam Filtering service is installed on the server and allowed by Plesk license. Data type: string. Allowed values: ok | error.
- The errcode node is optional. Is returns the error code if the check operation fails. Data type: integer.
- The errtext node is optional. It returns the error message if the check operation fails. Data type: string.
Samples
Request packet sample
The packet retrieving status of Spam Filtering service looks as follows:
Response:
If the SpamAssassin service is restricted by Plesk licence key, or a user does not have access to SpamAssassin management, the response is as follows:
If the SpamAssassin service was not found on the server, the response is as follows: