Delete virtual scanner

/api/2.0/fo/appliance/?action=delete

[POST]


Delete a virtual scanner appliance in the user's account. Deletion results in these actions: 1) the scanner will be removed from associated asset groups, and 2) scheduled scans using this scanner will be deactivated.

Is your virtual scanner running scans? If yes it’s not possible to delete it. We recommend you check to be sure the virtual scanner you want to delete is not running scans.

Input Parameters

Parameter

Description

action=delete

(Required)

echo_request={0|1}

(Optional) Specify 1 to view (echo) input parameters in the XML output. By default these are not included.

id={id}

(Required) A valid ID of a virtual scanner.

 

Sample - Delete virtual scanner

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl" -X "POST"

-d "action=delete&echo_request=1&id=12345"

"https://qualysapi.qualys.com/api/2.0/fo/appliance/"

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE APPLIANCE_LIST_OUTPUT SYSTEM

"https://qualysapi.qualys.com/api/2.0/fo/simple_return.dtd">

<SIMPLE_RETURN>

    <RESPONSE>

        <DATETIME>2018-05-02T09:26:01Z</DATETIME>

        <TEXT>Virtual scanner deleted successfully</ID>

        <ITEM_LIST>

             <ITEM>

                  <KEY>ID<KEY>

                  <VALUE>115<VALUE>

             </ITEM>

             <ITEM>

                  <KEY>DEACTIVATED_SCHEDULED_SCANS<KEY>

                  <VALUE>None<VALUE>

             </ITEM>

             <ITEM>

                  <KEY>AFFECTED_ASSET_GROUPS<KEY>

                  <VALUE>None<VALUE>

             </ITEM>

        <ITEM_LIST>

    </RESPONSE>

</SIMPLE_RETURN>