Purge hosts

1

unspecified

vulnerability + compliance data

0

unspecified

vulnerability data only

unspecified or 0

vm

vulnerability data only

unspecified or 0

pc

compliance data only

unspecified or 0

vm,pc

vulnerability + compliance data

1

vm

vulnerability + compliance data

1

pc

vulnerability + compliance data

1

vm,pc

vulnerability + compliance data

action=purge

(Required) The POST method should be used.

echo_request={0|1}

(Optional) Specify 1 to view input parameters in the XML output. When unspecified, parameters are not included in the XML output.

ids={value}

(Optional) Purge host information for certain host IDs/ranges. One or more host IDs/ranges may be specified. Multiple entries are comma separated. A host ID range is specified with a hyphen (for example, 190-400).Valid host IDs are required.

One of these host selection parameters must be specified in an API request: ids, ips, ag_ids or ag_titles. Multiple host selection parameters may be specified together in the same request.

ips={value}

(Optional) Purge host information certain IP addresses/ranges. One or more IPs/ranges may be specified. Multiple entries are comma separated. An IP range is specified with a hyphen (for example, 10.10.10.1-10.10.10.100).

One of these host selection parameters must be specified in an API request: ids, ips, ag_ids or ag_titles. Multiple host selection parameters may be specified together in the same request.

ag_ids={value}

(Optional)  Purge hosts belonging to asset groups with certain IDs. One or more asset group IDs and/or ranges may be specified. Multiple entries are comma separated. A range is specified with a dash (for example, 386941-386945). Valid asset group IDs are required.

One of these host selection parameters must be specified in an API request: ids, ips, ag_ids or ag_titles. Multiple host selection parameters may be specified together in the same request. These parameters are mutually exclusive and cannot be specified together: ag_ids and ag_titles.

ag_titles={value}

(Optional)  Purge hosts belonging to asset groups with certain strings in the asset group title. One or more asset group titles may be specified. Multiple entries are comma separated (for example, My+First+Asset+Group,Another+Asset+Group).

One of these parameters must be specified in an API request: ids, ips, ag_ids or ag_titles. Multiple host selection parameters may be specified together in the same request. These parameters are mutually exclusive and cannot be specified together: ag_ids and ag_titles.

network_ids={value}

(Optional, and valid only when the Network Support feature is enabled for the user’s account) Restrict the request to certain custom network IDs. Multiple network IDs are comma separated.

no_vm_scan_since={date}

(Optional)  Purge hosts not scanned since a certain date and time (optional). The date/time is specified in YYYY-MM-DD[THH:MM:SSZ] format (UTC/GMT), like “2007-07-01” or “2007-01-25T23:12:00Z”.

User Permissions: An Auditor cannot specify this parameter.

no_compliance_scan_since={date}

(Optional)  Purge compliance hosts not scanned since a certain date and time (optional). This parameter is invalid for an Express Lite user.

The date/time is specified in YYYY-MM-DD[THH:MM:SSZ] format (UTC/GMT), like “2007-07-01” or “2007-01-25T23:12:00Z”.

User Permissions: A sub-account (Unit Manager, Scanner or Reader) can specify this parameter only when the user account is granted certain permissions to purge compliance information.

data_scope={value}

(Optional) The type of data to purge. Specify “vm” to purge vulnerability data, specify “pc” to purge compliance data, or specify both as a comma separated list to purge both types of data.

If compliance_enabled=1 is specified in the same request, then vulnerability and compliance data will both be purged regardless of the data_scope value.

compliance_enabled={0|1}

(Optional)  This parameter is valid only when the policy compliance module is enabled for the user account.

Specify 1 to purge compliance hosts in the user’s account. These hosts are assigned to the PC module. When selected, the service will remove vulnerability data and compliance data associated with the selected hosts.

Specify 0 to purge hosts which are not assigned to the PC module. When specified (without data_scope), the service will remove only vulnerability information associated with the selected hosts.

Note: A sub-account (Unit Manager, Scanner or Reader) can specify this parameter only when the user account is granted permissions to purge compliance information. An Auditor does not have permission to set compliance_enabled=0.

os_pattern={expression}

(Optional)  Purge only hosts which have an operating system matching a certain regular expression. An empty value cannot be specified. Use “%5E%24” to match empty string.

Important: The regular expression string you enter must follow the PCRE standard and it must be URL encoded.

Sample regular expression strings for matching OS names:

Check API Sample 17

Qualys API - Host List Detection API samples (GitHub)

Click here for info on PCRE format.