Update existing domains and related netblocks in the subscription. The domains defined may be used as targets for network scans (maps). Basic HTTP authentication is required. Session based authentication is not supported using this API. Permissions - Manager user role is required.
Parameter |
Required/Optional |
Data Type |
Description |
---|---|---|---|
action={update} |
Required | String | Specify the update action to update/edit an existing domain. |
domain/id | Required | String | Specify either the name or the id of the domain that you want to update. |
netblock | Required | Integer | Specify netblocks of domain. If you specify the value, it gets updated. If you don’t specify any value, then the Qualys system clears the associated netblocks of domains. |
network_id | Optional | Integer | If the network feature is enabled for your subscription, then specify the network ID for updating a domain. |
API Request
curl --location --request POST
'<qualys_base_url>/api/2.0/fo/asset/domain/?action=update&domain=Vulndash
board.com&netblock=12.12.12.12' \
--header 'X-Requested-With: curl' \
--header 'Authorization: XXXXXXXXXXX' \
--data ''
XML Output
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE SIMPLE_RETURN SYSTEM
"<qualys_base_url>/api/2.0/simple_return.dtd">
<SIMPLE_RETURN>
<RESPONSE>
<DATETIME>2023-10-25T09:40:18Z</DATETIME>
<TEXT>Domain successfully updated.</TEXT>
</RESPONSE>
</SIMPLE_RETURN>