Delete a DNS override that is in the user’s scope.
Permissions required - User must have WAS module enabled. User account must have these permissions: Access Permission “API Access”.
Optional elements are used to retrieve DNS overrides to delete. When multiple elements are specified, parameters are combined using a logical AND. All dates must be entered in UTC date/time format.
Click here for available operators
|
Parameter |
Mandatory /Optional |
Data Type |
Description |
|---|---|---|---|
|
id |
Optional |
integer |
The ID of the DNS override. |
|
name |
Optional |
text |
The name given to the DNS override. |
|
tags |
Optional |
text |
Filter by tags applied. |
|
tags.id |
Optional |
integer |
ID of the tag assigned to DNS override. |
|
tags.name |
Optional |
text |
Tag name assigned to DNS override. |
|
createdDate |
Optional |
date |
The date when the DNS override was created in WAS, in UTC date/time format. |
|
updatedDate |
Optional |
date |
The date when the DNS override was updated in WAS, in UTC date/time format. |
|
owner.id |
Optional |
Long with operator: EQUALS, IN, NOT EQUALS, GREATER or LESSER |
ID of the owner who created the DNS override. |
|
owner.name |
Optional |
text |
Full name of the user who created the DNS override. |
|
owner.username |
Optional |
text |
Username of the owner who created the DNS override. (like user_ab3). |
API request
curl -u "USERNAME:PASSWORD" -H "content-type: text/xml" -X "POST"--data-binary@-
"<qualys_base_url>/qps/rest/3.0/delete/was/dnsoverride/" < file.xml
Note: "file.xml" contains the request POST data.
Request POST Data
<ServiceRequest>
<filters>
<Criteria field="id" operator="EQUALS">57020</Criteria>
</filters>
<data>
<DnsOverride>
<id>57220</id>
</DnsOverride>
</data>
</ServiceRequest>
XML response
<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/3.0/was/dnsoverride.xsd">
<responseCode>SUCCESS</responseCode>
<count>1</count>
<data>
<DnsOverride>
<id>57220</id>
</DnsOverride>
</data>
</ServiceResponse>