Launch VM scan

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

[POST]

Launch a VM scan in the user's account.

Input Parameters

Click here to view parameters for launching VM scans.

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://qualysapi.qualys.com/api/2.0/fo/scan/"

 

XML output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE SIMPLE_RETURN SYSTEM "https://qualysapi.qualys.com/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)

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://qualysapi.qualys.com/api/2.0/fo/scan/" > outputfile.txt

 

 

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://qualysapi.qualys.com/api/2.0/fo/scan/"

 

 

 

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://qualysapi.qualys.com/api/2.0/fo/scan/"

 

 

 

DTD

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