List Assets API
Search list of assets on which CAR is enabled.
Input ParametersInput Parameters
Parameter |
Mandatory/Optional |
Data Type |
Description |
---|---|---|---|
Authorization |
Mandatory |
string |
Authorization token to authenticate to the Qualys Enterprise TruRisk™ Platform. Prepend the token with 'Bearer', followed by a space. For example: Bearer <authToken> |
API Request:
curl -X POST
'https://<qualys_base_url>/sm/v1/assets/search'
--header 'Authorization: Bearer <authToken>
Response:
" "{ " ""errorCode":null, " ""message":null, " ""body":{ " ""totalCount":"<NUMBER OF ASSETS>", " ""list":[ " "{ " ""sortValues":[ ], " ""data":{ " ""interfaces":[ " "{ " ""hostname":"<ASSET NAME>", " ""macAddress":"<MAC ADDRESS>", " ""address":"<ASSET IP>", " ""interfaceName":"eth0"" ", " "{ " ""hostname":null, " ""macAddress":"<MAC ADDRESS>", " ""address":"fe80:0:0:0:82a:39ff:feda:4fa5", " ""interfaceName":"eth0"" " }" " ], " ""address":"<ASSET IP>", " ""activatedForModules":[ " ""PC"" " ], " ""operatingSystem":"OPERATING SYSTEM", " ""assetType":"HOST", " ""tags":[ 12047163, 11516586, 8543820, 9738814 ], " ""customerUuid":"<CUSTOMER UUID>", " ""assetId":"<ASSET ID>", " ""customerId":"<CUSTOMER ID>", " ""name":"<ASSET NAME>", " ""agentVersion":"<CLOUD AGENT VERSION>", " ""id":"<ASSET IP>", " ""agentUuid":"<AGENT UUID>"" " }" " }, " "{ " ""sortValues":[ ], " ""data":{ " ""interfaces":[ " "{ " ""hostname":"<HOST NAME>", " ""macAddress":"<MAC ADDRESS>", " ""address":"<ASSET IP>", " ""interfaceName":"ens160"" " }, " "{ " ""hostname":null, " ""macAddress":"<MAC ADDRESS>", " ""address":"<ASSET IP>", " ""interfaceName":"virbr0"" " }, " "{ " ""hostname":null, " ""macAddress":"<MAC ADDRESS>", " ""address":"<ASSET IP>", " ""interfaceName":"ens160"" " }" " ], " ""address":"<ASSET IP>", " ""activatedForModules":[ " ""PC"" " ], " ""operatingSystem":"<OPERATING SYSTEM>", " ""assetType":"HOST", " ""tags":[ 8543820 ], " ""customerUuid":"<CUSTOMER UUID>", " ""assetId":"<ASSET ID>", " ""customerId":"<CUSTOMER ID>", " ""name":"<HOST NAME>", " ""agentVersion":"<AGENT VERSION>", " ""id":"<AGENT ID>", " ""agentUuid":"<AGENT UUID>"" " }" " }, " "{ " ""sortValues":[ ], " ""data":{ " ""interfaces":[ " "{ " ""hostname":"<ASSET NAME>", " ""macAddress":"<MAC ADDRESS>", " ""address":"<ASSET IP>", " ""interfaceName":"Intel(R) PRO/1000 MT Network Connection"" " }" " ], " ""address":"<ASSET IP>", " ""activatedForModules":[ " ""AGENT_FIM", " ""AGENT_PC", " ""FIM", " ""PC"" " ], " ""operatingSystem":"<OPERATING SYSTEM>", " ""assetType":"HOST", " ""tags":[ 17970415, 12047183, 11172212, 8546868, 14695569, 12047182, 8543820 ], " ""customerUuid":"2<CUSTOMER UUID>", " ""assetId":"<ASSET ID>", " ""customerId":"<CUSTOMER ID>", " ""name":"<ASSET NAME>", " ""agentVersion":"<AGENT VERSION>", " ""id":"<AGENT ID>", " ""agentUuid":"<AGENT UUID>"" " }" " }" " ]" " }" " }
To know the details of the response codes, refer to Appendix.