Search Host Assets - BlinkOps Documentation

Search for assets in the Global IT Asset Inventory that satisfy the specified filter criteria, including hardware, software, tags, and agent information. Note: The Qualys API enforces rate limits. For more information, refer to Qualys documentation.

External DocumentationTo learn more, visit the Qualys Global IT Asset Inventory documentation.

Parameters

Parameter	Description
Exclude Fields	Select the fields to exclude from the response. All other fields are returned normally.
Filter	The Qualys QQL query used to filter the assets. For Example: `netbiosName: 'acme' AND assetName: 'acme.qualys.com'` or `operatingSystem.category1:Linux`.
Include Fields	Select the fields to include in the response. All other fields are returned with a `null` value.
Last Modified Date	The date used to return only assets modified on or after this date.
Last Seen Asset ID	The asset ID used to return only assets with an ID greater than this value.
Page Size	The maximum number of assets to return per page. The maximum value is `100`.

Example Output

{
	"responseMessage": "Valid API Access",
	"count": 1,
	"responseCode": "SUCCESS",
	"lastSeenAssetId": 10685701,
	"hasMore": 1,
	"assetListData": {
		"asset": [
			{
				"assetId": 10685701,
				"assetUUID": "c146d7e5-2d1d-4201-b654-0990d09e357b",
				"hostId": 2289420,
				"lastModifiedDate": "2019-08-01T21:53:16.048Z",
				"agentId": "c146d7e5-2d1d-4201-b654-0990d09e357b",
				"assetType": "HOST",
				"address": "10.90.2.249",
				"dnsName": null,
				"assetName": "Amy-POD4-Agent-quays_iz72-Centos7+mysql",
				"netbiosName": null,
				"operatingSystem": {
					"osName": "CentOS Linux 7.6.1810",
					"fullName": "CentOS 7",
					"category1": "Linux",
					"category2": "Server"
				},
				"openPortListData": {
					"openPort": [
						{
							"port": 22,
							"protocol": "TCP",
							"detectedService": "An open source SSH server daemon"
						}
					]
				},
				"softwareListData": {
					"software": [
						{
							"fullName": "OpenBSD OpenSSH 7 7.4 (7.4p1)",
							"productName": "OpenSSH",
							"publisher": "OpenBSD",
							"version": "7.4"
						}
					]
				},
				"provider": "AWS",
				"cloudProvider": {
					"aws": {
						"ec2": {
							"instanceId": "i-087965612d096c93d",
							"instanceState": "RUNNING",
							"instanceType": "t2.micro",
							"publicIpAddress": "3.86.24.68",
							"region": {
								"code": "us-east-1",
								"name": "US East (N. Virginia)"
							}
						}
					}
				},
				"agent": {
					"version": "2.4.0.75",
					"lastCheckedIn": 1564695367151,
					"lastInventory": 1564695367000
				},
				"tagList": {
					"tag": [
						{
							"tagId": 104776729,
							"tagName": "Cloud Agent",
							"businessImpact": "LOW"
						}
					]
				},
				"serviceList": {
					"service": [
						{
							"name": "auditd.service",
							"status": "loaded/active/running"
						}
					]
				}
			}
		]
	}
}

Workflow Library Example

Search Host Assets with Qualys Global It Asset Inventory and Send Results Via Email

Preview this Workflow on desktop