Update the containerized scanner appliance details in your account.
|
Parameter |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
|
action=update |
Required |
String | Specify action to update scanner appliance. |
|
echo_request={0|1} |
Optional |
Integer | Specify 1 to view (echo) input parameters in the XML output. By default, these are not included. |
| id={id} | Required | Integer | A valid ID of a containerized scanner. |
| name={string} | Optional | String | The friendly name. This name can’t already be assigned to an appliance in your account. It can be a maximum of 32 characters, spaces are not allowed. |
| polling_interval={value} | Optional | Integer | The polling interval, in seconds. A valid value is 60 to 3600 (we recommend 180 which is the default). This is the frequency that the containerized scanner will attempt to connect to our Cloud Security Platform. The appliance calls home to provide health updates/heartbeats to the platform, to get software updates from the platform, to learn if new scan jobs have been requested by users, and to upload scan results data to the platform, if applicable |
| comment={value} | Optional | Integer | User-defined comments. |
| set_tags= {value} | Optional | Integer | Specify tag to be assigned to the scanner appliance. Both containerized and physical scanners can be tagged. These parameters are mutually exclusive and cannot be specified in the same request: set_tags and add_tags, remove_tags. |
| add_tags= {value} | Optional | Integer | Specify tag to be added to the existing list of tags assigned to the scanner. Multiple entries are comma separated. These parameters are mutually exclusive and cannot be specified in the same request: set_tags and add_tags, remove_tags. |
| remove_tags= {value} | Optional | Integer | Specify tag to be removed from the existing list of tags assigned to scanner. Multiple tags are comma separated. These parameters are mutually exclusive and cannot be specified in the same request: set_tags and add_tags, remove_tags. |
| tag_set_by= {id|name} | Optional | String | Specify "id" (the default) to select a tag set by providing tag IDs. Specify “name” to select a tag set by providing tag names. |
| enable_ipv6=0 | Optional | Integer | Enable or disable IPv6 on LAN. Specify 1 to enable IPv6 and 0 to disable it. |
API Request
curl --location --request POST
'https://<qualys_base_url>/api/2.0/fo/appliance/qcss/?action=updat
e&echo_
request=1&name=QcssScannerApi1_updated&id=1227168' \
--header 'X-Requested-With: abc' \
--header 'Authorization: Basic cXdlYl9ybTI6UWF0ZW1wMTIzIw=='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> <REQUEST> <DATETIME>2024-03-27T11:05:26Z</DATETIME> <USER_LOGIN>qweb_rrr</USER_LOGIN> <RESOURCE>https:// <qualys_base_url>/api/2.0/fo/appliance/qcss/ </RESOURCE> <PARAM_LIST> <PARAM> <KEY>action</KEY> <VALUE>update</VALUE> </PARAM> <PARAM> <KEY>echo_request</KEY> <VALUE>1</VALUE> </PARAM> <PARAM> <KEY>name</KEY> <VALUE>QcssScannerApi1_updated</VALUE> </PARAM> <PARAM> <KEY>id</KEY> <VALUE>1227168</VALUE> </PARAM> </PARAM_LIST> </REQUEST> <RESPONSE> <DATETIME>2024-03-27T11:05:26Z</DATETIME> <TEXT>Containerized scanner updated successfully</TEXT> <ITEM_LIST> <ITEM> <KEY>ID</KEY> <VALUE>1227168</VALUE> </ITEM> </ITEM_LIST> </RESPONSE> </SIMPLE_RETURN>
<platform API server>/api/2.0/fo/appliance/qcss/?action=update_output.dtd