Filtering is the way the request XML packet indicates the object (a web user or several) to which the operation will be applied. The request XML packet filters web user accounts using a special <filter> node.
Parameters, nested in the filter node are called filtering rule. A filter contains as many different filtering rule types as the number of different parameters nested in the XML presentation of the filter node. A single operation can use only parameters of the same type in the filtering rule.
The filter for this operator is presented by type logRotationFilterType (
logrotation.xsd) and structured as follows:
The filter node can be left blank (<filter/>). In this case all domains available for user specified by login credentials will be matched.
A single filter can specify multiple domains defined either by ID, name, client ID or client name in the second. For example, the filter that matches all domains of the clients with IDs 8,9, and 10 looks as follows:
If an operation in a request packet uses filters, the filter-id node is nested in a response packet. It returns the filtering rule parameter. If one of the following values was set as a filter rule parameter, it is returned in the filter-id node of the response packet.
It is done to trace request parameters in case of error. Data type: anySimple.