Using this API, you can get a list of more than ten thousand assets enabled for your Patch Management subscription.
Parameter |
Mandatory/Optional |
Data Type |
Description |
---|---|---|---|
searchAfter |
Optional |
string |
Specify the searchAfter parameter to search for results after that. This is a combination of an asset_name and asset_id separated by a comma. |
sortOrder |
Optional |
string |
Specify the order to sort asset_name and asset_id. |
pageSize |
Optional |
string |
Specify the number of rows to be displayed per page. |
platform |
Optional |
string |
Specify the platform type. Example: Windows and Linux |
API request
curl -X 'POST' \
'<qualys_base_url>/pm/v1/assets?sortOrder=ASC&platform=Windows' \
-H 'accept: application/json' \
-H 'searchAfter: PMUI_AUTOMATION_ASSET_WINDOWS_EXCLUSION,ecd86069-c015-4b0e-9488-8ef14a99026d' \
-H 'Authorization: Bearer <Bearer_Token>' \
-H 'Content-Type: application/json' \
-d '{
"query": "installedPatchCount>1",
"havingQuery": "downloadMethod:AcquireFromVendor and rebootRequired:true",
"attributes": "name,id,platform"}'
Response
[
{
"platform": "Windows",
"name": "PMUI_AUTOMATION_MOCK_ASSET_WINDOWS_1",
"id": "e6eaf17a-3069-4c1e-a5dc-df0049cb9f60"
},
...
{
"platform": "Windows",
"name": "PMUI_AUTOMATION_MOCK_ASSET_WINDOWS_5",
"id": "f87461bc-16ad-4621-97ef-c496676815da"
}
]
API request
curl -X 'POST' \ '<qualys_base_url>/pm/v1/assets?sortOrder=ASC&pageSize=2&platform=Linux' \
-H 'accept: application/json' \
-H 'searchAfter: PMUI_AUTOMATION_MOCK_ASSET_LINUX_1,6af553e1-fc5a-4791-b339-44f71df5eb81' \
-H 'Authorization: Bearer <Bearer_Token>' \
-d '{
"query": "missingPatchCount>0",
"attributes": "name,id,platform"}'
Response
[
{
"platform": "Linux",
"name": "PMUI_AUTOMATION_MOCK_ASSET_LINUX_2",
"id": "b3ca4393-3daa-45df-b1c6-b5378d97a2e3"
},
{
"platform": "Linux",
"name": "PMUI_AUTOMATION_MOCK_ASSET_LINUX_3",
"id": "144d85c6-a0d3-4b66-8d92-0609ea309aef"
}
]