Documentation is now available for the Fall 2020 Update release!

Get latest antivirus definitions on resources

This endpoint is used to retrieve the latest antivirus definitions installed on resources.

Leave Feedback

URL

GET https://{api-url}/api/v2/tenants/{tenantId}/resources/antivirus/search

Sample URLs

To retrieve the latest antivirus definitions installed on resources:

https://{api-url}/api/v2/tenants/client_8/resources/antivirus/search
To retrieve the latest antivirus definitions based on antivirus definition status:

https://{api-url}/api/v2/tenants/client_8/resources/antivirus/search?pageNo=1&pageSize=100&queryString=status:UPTODATE

Parameters

FieldDefault Value
pageNo={pageNo}1
pageSize={pageSize}100
isDescendingOrder={true/false}true
sortName={field}scanDate
queryString={queryString}NA

NA indicates that the value is not applicable.

Query variables

Query VariablesValuesDescription
status
  • OUTOFDATE
  • UPTODATE
Antivirus definition status on a resource.
Example: UPTODATE.

Sample response

{
	"results": [{
			"name": "McAfee VirusScan Enterprise",
			"version": "8.8.0.1804",
			"currentDefinition": "8637",
			"currentDefinitionDate": "2017-08-28T00:00:00+0000",
			"scanDate": "2017-08-29T07:59:10+0000",
			"supported": true,
			"status": "UPTODATE",
			"resource": {
				"id": "d9dba1ce-dec0-46b6-8ad6-51975cd9991e",
				"hostName": "HYDLPT082",
				"ipAddress": "192.123.23.1",
				"osName": "Microsoft Windows 8.1 Pro "
			}
		},
		{
			"name": "VIPRE Enterprise",
			"version": "8.8.0.1804",
			"currentDefinition": "8575",
			"currentDefinitionDate": "2017-01-28T05:17:13+0000",
			"scanDate": "2017-02-01T00:00:00+0000",
			"supported": false,
			"status": "OUTOFDATE",
			"resource": {
				"id": "2912ca9f-5c62-451f-82a8-8c08ca9c9447",
				"hostName": "HYDLPT159",
				"ipAddress": "162.12.2.233",
				"osName": "Microsoft Windows 8.1 Enterprise Edition, 64-bit"
			}
		}
	],
	"totalResults": 2,
	"orderBy": "scanDate",
	"pageNo": 1,
	"pageSize": 100,
	"totalPages": 1,
	"nextPage": false,
	"previousPageNo": 0,
	"descendingOrder": true
}