Count of Assets
Get count of assets satisfying the specified filter criteria.
Input ParametersInput Parameters
Parameter |
Mandatory /Optional |
Data Type |
Description |
---|---|---|---|
filter |
Optional |
string |
Filter the events list by providing a filter in json and xml format. Make sure your filter criteria is provided in xml/json format in the request body. If you don’t provide filter parameter, it will show details of all the assets. For more information on supported operators, refer Supported Operators. For example (json):
For example (xml):
|
assetLastUpdated |
Optional |
string |
Shows records updated on or after this date with the UTC format as yyyy-MM-ddTHH:mmZ e.g. 2019-03-01T11:30Z This date gets updated whenever any activity happens on the asset. Few examples of such activity: - Vulnerability Management scan - Policy Compliance scan - Inventory collection - Security Configuration Assessment - CertView scan - AssetView or CloudView connector run - Secure Enterprise Mobility scan - Out-of-Band Configuration Assessment - Asset rename - Purge of VM, PC, OCA, CertView records - Agent manifest download - Asset Inventory asset identification updates |
lastSeenAssetId |
Optional |
string |
Use to get the count of assets having asset id greater than the specified last seen assetid. If you want to get a count of assets that fall after the specific asset id, refer to the following example: Example: https://gateway.qg1.apps.qualys.com/rest/2.0/count/am/asset?lastSeenAssetId=6920718 Consider the scenario, wherein you have 1000 assets. In the API call, if you enter the asset id of the 200th asset in the lastSeenAssetId parameter, the first 200 assets are skipped from the count and the count of the rest of the assets, which is 800 is shown. |
Authorization |
Mandatory |
string |
Authorization token to authenticate to the Qualys Cloud Platform. Prepend token with "Bearer" and one space. For example - Bearer authToken |
Sample - Get Count of all assets with filter criteriaSample - Get Count of all assets with filter criteria
API Request
curl -X POST -H "Accept: */*"
-H "Authorization: Bearer <JWTToken>"
-H "Content-Type: application/json"
-i "<qualys_base_url>/rest/2.0/count/am/asset" filter.json
Here, filter.json file is the request in JSON format.
Sample - Request body in JSON format (filter.json)
{
"filters":[
{
"field":"software.authorization",
"operator":"EQUALS",
"value":"Authorized"
}
]
}
Response
{
"count":850,
"responseCode":"SUCCESS",
"responseMessage":"Valid API Access"
}
Sample - Added Attribute to "cloudProvider" fieldSample - Added Attribute to "cloudProvider" field
API Request
curl --location --request POST
'<qualys_base_url>/rest/2.0/count/am/asset'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/xml'
--data-raw
'<FilterRequest>'
Filter
<FilterRequest>
<filters>
<Criteria field="alibaba.instance.instanceId" operator="EQUALS">
<value>Instance_MN72C8</value>
</Criteria>
</filters>
</FilterRequest>
Response
{
"count":1,
"responseCode":"SUCCESS",
"responseMessage":"Valid API Access"
}
Sample - Added hostingCategory1 informationSample - Added hostingCategory1 information
API Request
curl --location --request POST
'<qualys_base_url>/rest/2.0/count/am/asset'
--header 'Authorization:Bearer <JWT Token>'
--header 'Content-Type: application/xml'
--data
'<FilterRequest>
Filter
<FilterRequest>
<filters>
<Criteria field="asset.hostingCategory1" operator="EQUALS">
<value>Cloud</value>
</Criteria>
</filters>
</FilterRequest>
Response
{
"count":77,
"responseCode":"SUCCESS",
"responseMessage":"Valid API Access"
}
Sample - Added Software Instance Details InformationSample - Added Software Instance Details Information
API Request
curl --location --request POST
'<qualys_base_url>/rest/2.0/count/am/asset'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/xml'
--data-raw '<FilterRequest>'
Filter
<FilterRequest>
<filters>
<criteria field="software.hasRunningInstance" operator="EQUALS">
<value>true</value>
</criteria>
</filters>
</FilterRequest>
Response
{
"count": 19,
"responseCode": "SUCCESS",
"responseMessage": "Valid API Access"
}
Sample - Added easmTags InformationSample - Added easmTags Information
API Request
curl --location --request POST
'<qualys_base_url>/rest/2.0/count/am/asset'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/xml'
--data '<FilterRequest>
Filter
<FilterRequest>
<filters>
<Criteria field="easm.tags.name"
operator="EQUALS"><value>cloud</value></Criteria>
</filters>
</FilterRequest>
Response
{
"count": 173,
"responseCode": "SUCCESS",
"responseMessage": "Valid API Access"
}
Sample - Get the Count of Scanner AssetsSample - Get the Count of Scanner Assets
API Request
curl --location
'<qualys_base_url>/rest/2.0/count/am/asset?=null' \
--header 'Content-Type: application/xml' \
--header 'Authorization: Bearer <JWT_Token>' \
--data '<FilterRequest>
<filters>
<Criteria field="asset.type" operator="EQUALS"><value>SCANNER</value></Criteria>
</filters>
</FilterRequest>'
API Response
{
"count": 7,
"responseCode": "SUCCESS",
"responseMessage": "Valid API Access"
}
Sample - Get the Count of LPAR AssetsSample - Get the Count of LPAR Assets
API Request
curl -X POST
'<qualys_base_url>/rest/2.0/count/am/asset'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/xml'
--data-raw
Filter in XML
<FilterRequest>
<filters>
<Criteria field="asset.lparID" operator="EQUALS">
<value>6 LXAG-A72TL5-22</value>
</Criteria>
</filters>
</FilterRequest>
API Response
{
"count":1,
"responseCode":"SUCCESS",
"responseMessage":"Valid API Access"
}