Launch VM Scan

POST/api/2.0/fo/scan/?action=launch

Launch a VM scan in the user's account.

Input ParametersInput Parameters

Click here to view parameters for launching VM scans.

Sample - Launch VM Scan (IP Address)Sample - Launch VM Scan (IP Address)

API Request

curl -u "username:password" -H "X-Requested-With:curl demo" -d "action=launch&scan_title=My+Vulnerability+Scan&target_from=tags&tag_set_by=name&tag_set_include=Windows&option_id=43165&iscanner_name=scanner1" "https://<qualys_base_url>/api/2.0/fo/scan/"

XML Output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE SIMPLE_RETURN SYSTEM "https://<qualys_base_url>/api/2.0/simple_return.dtd">
<SIMPLE_RETURN>
  <RESPONSE>
    <DATETIME>2018-01-15T21:32:40Z</DATETIME>
    <TEXT>New vm scan launched</TEXT>
    <ITEM_LIST>
      <ITEM>
        <KEY>ID</KEY>
        <VALUE>136992</VALUE>
      </ITEM>
      <ITEM>
        <KEY>REFERENCE</KEY>
        <VALUE>scan/1358285558.36992</VALUE>
      </ITEM>
    </ITEM_LIST>
  </RESPONSE>
</SIMPLE_RETURN>

Sample - Launch Scan  (FQDN and Asset Group)Sample - Launch Scan  (FQDN and Asset Group)

API Request

curl -H "X-Requested-With: Curl" -u "USERNAME:PASSWORD" -X "POST" -d"action=launch&option_title=Initial+Options&fqdn=domain.qualys.com&iscanner_name=scanner_us&scan_title=My+Scan&asset_groups=My+AG""https://<qualys_base_url>/api/2.0/fo/scan/" > outputfile.txt

Sample - Launch VM Scan (Asset Tags)Sample - Launch VM Scan (Asset Tags)

API Request

curl -u 'username:password' -H 'X-Requested-With:curl demo' -d "action=launch&scan_title=My+Vulnerability+Scan&target_from=tags&tag_set_by=name&tag_set_include=Windows&option_id=43165&iscanner_name=scanner1" "https://<qualys_base_url>/api/2.0/fo/scan/"

Example - Launch VM Scan (All Scanners in Network)Example - Launch VM Scan (All Scanners in Network)

API Request

curl -u 'username:password' -H 'X-Requested-With:curl demo' -d "action=launch&scan_title=scan3&option_title=Initial+Options&ip_network_id=12807913&scanners_in_network=1&asset_groups=AG1-GDN" "https://<qualys_base_url>/api/2.0/fo/scan/"

DTD

<platform API server>/api/2.0/simple_return.dtd