Launch PC Scan on EC2 Assets
Click to view navigation pane

Launch PC Scan on EC2 Assets

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

This API is used to launch PC scans on your Amazon EC2 assets (in your Amazon Web Services account).
A few things to consider...
- EC2 Scanning must be enabled for your Qualys account.
- Managers and Unit Managers can launch EC2 scans. - Before scanning you’ll need to complete some set up steps. See Securing Amazon Web Services with Qualys

Input ParametersInput Parameters

Click here to view parameters for launching PC scans.

Sample - Launch EC2 Compliance ScanSample - Launch EC2 Compliance Scan

API Request

curl -u "username:password" -H "X-Requested-With:curl demo" -d "action=launch&scan_title=MyEC2+Scan&connector_name=EC2_Connector&ec2_endpoint=us-east-1&target_from=tags&use_ip_nt_range_tags=0 &tag_include_selector=any&tag_set_by=id&tag_set_include=1558997,1559222&option_id=43165&iscanner_name=EC2-1" "https://<qualys_base_url>/api/2.0/fo/scan/compliance/"

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-02-25T21:32:40Z</DATETIME>
    <TEXT>New pc 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>

DTD

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