/api/2.0/fo/scan/?action={action}
Various actions you can take on VM scans i.e. cancel, pause, resume, delete, fetch.
Parameter |
Description |
action={value} |
(Required) One of these actions cancel - Stop a scan in progress (POST) pause - Pause a scan in progress (POST) resume - Restart a scan that has been paused (POST) delete - Delete a scan (POST) fetch - Download scan results when scan has status Finished, Canceled, Paused or Error (GET or POST) |
echo_request={0|1} |
(Optional) Specify 1 to view (echo) input parameters in the XML output. By default these are not included. |
scan_ref={value} |
(Required) The scan reference of a scan. The scan status of this scan must be Finished. |
ips={value} |
(Optional for fetch request) Show only certain IP addresses/ranges in the scan results. One or more IPs/ranges may be specified. A range entry is specified using a hyphen (for example, 10.10.10.1-10.10.10.20). Multiple entries are comma separated. |
mode={brief|extended} |
(Optional for fetch request) The verbosity of the scan results details. One verbosity mode may be specified: brief (the default) or extended. The brief output includes this information: IP address, DNS hostname, NetBIOS hostname, QID and scan test results if applicable. The extended output includes the brief output plus this extended information: protocol, port, an SSL flag ("yes" is returned when SSL was used for the detection, "no" is returned when SSL was not used), and FQDN if applicable. |
output_format={csv|json| csv_extended|json_extended} |
(Optional for fetch request) The output format of the vulnerability scan results. A valid value is: csv (the default), json (for JavaScript Object Notation(), csv_extended, json_extended. |
client_id={value} |
(Optional for fetch request) Id assigned to the client (Consultant type subscription only). Parameter client_id or client_name may be specified for the same request. |
client_name={value} |
(Optional for fetch request) Name of the client (Consultant type subscription only). Parameter client_id or client_name may be specified for the same request. |
API request
curl -H "X-Requested-With: Curl Sample" -d "action=cancel&scan_ref=234234234.12345" -b "QualysSession=71e6cda2a35d2cd404cddaf305ea0208; path=/api; secure" "https://qualysapi.qualys.com/api/2.0/fo/scan/"
API request
curl -H "X-Requested-With: Curl Sample" -d "action=pause&scan_ref=234234234.12345" -b "QualysSession=71e6cda2a35d2cd404cddaf305ea0208; path=/api; secure" "https://qualysapi.qualys.com/api/2.0/fo/scan/"
API request
curl -H "X-Requested-With: Curl Sample" -d "action=resume&scan_ref=234234234.12345" -b "QualysSession=71e6cda2a35d2cd404cddaf305ea0208; path=/api; secure" "https://qualysapi.qualys.com/api/2.0/fo/scan/"
<platform API server>/api/2.0/simple_return.dtd