Count Tags

[POST] /qps/rest/2.0/count/am/tag

Count all the children of a tag.



Permissions required - Managers with full scope, other users must have Access Permission “API Access”

Input ParametersInput Parameters

Click here for available operators

Parameter

Mandatory

/Optional

Data Type

Description

id 

 

integer

 

name 

 

text

 

parent 

 

integer

 

ruleType

   

STATIC, GROOVY, OS_REGEX, NETWORK_RANGE, NAME_CONTAINS, INSTALLED_SOFTWARE, OPEN_PORTS, VULN_EXIST, ASSET_SEARCH, CLOUD_ASSET

provider

   

EC2, AZURE, GCP, IBM, OCI

color

   

Text formatted as #FFFFFF where F can be any value between 0-9 and A-F

Sample - Get count of all children of tag IDSample - Get count of all children of tag ID

API request

curl -u "USERNAME:PASSWORD" -H "content-type: text/xml" -X "POST"
--data-binary @-
"<qualys_base_url>/qps/rest/2.0/count/am/tag" < file.xml
Note: “file.xml” contains the request POST data.     
    

Request POST data

 <ServiceRequest>
    <filters>
        <Criteria field="parent" operator="EQUALS">12345</Criteria>
    </filters>
</ServiceRequest>     
    

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/2.0/am/tag.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>2</count>
</ServiceResponse>
<responseCode>SUCCESS</responseCode>      
    

XSD

<platform API server>/qps/xsd/2.0/am/tag.xsd