Device List - Managed Antivirus: mav_scan_device_list

Service name: mav_scan_device_list

https://SERVER/api/?apikey=yourAPItoken&service=mav_scan_device_list

&required_parameters=required_parameters

[&optional_parameters=optional_parameters]

Managed Antivirus specified device list.

Parameters

Default

0

0

2

Example Service Call =mav_scan_device_list

https://SERVER/api/?apikey=yourAPItoken&service=mav_scan_device_list&deviceid=DEVICEID&v=VERSION

Example Response

VIPRE engine: the following example response displays data for scans on a device running the Managed Antivirus VIPRE engine.

<?xml version="1.0" ?>

<scans>

<scan>

    <threateventid>136</threateventid>

    <deviceid>6164</deviceid>

    <status>3</status>

    <scantype>Deep scan</scantype>

    <event_type>1</event_type>

    <scanstartdatetime>2011-05-18 12:00:01</scanstartdatetime>

    <scanenddatetime>2011-05-18 12:30:49</scanenddatetime>

    <threat_count>1</threat_count>

    <trace_count>1</trace_count>

    <quarantine_count>1</quarantine_count>

    <cookies_scanned>0</cookies_scanned>

    <files_scanned>20837</files_scanned>

    <folders_scanned>2046</folders_scanned>

    <registry_scanned>16528</registry_scanned>

    <processes_scanned>25</processes_scanned>

    <scan_errors>2</scan_errors>

    <duration>00:30:48</duration>

</scan>

</scans>

Field Descriptions

A scans element containing zero or more entries (scan elements in XML), each scan having:

Description

Unique identifier of the threat.

Unique identifier of the device being monitored

Numeric representation of the scan status, one of:

Scan type, one of

VIPRE Engine: Please note that where a scan is still running the VIPRE engine will have in progress appended to the scantype.

Event type, one of:

Scan start date and time in agent local time.

For VIPRE engine scans currently in progress the time string also includes the number of days/hours/minutes since the scan began.

Scan end date and time in agent local time (for scans that have already completed)

Number of threats detected

Number of traces detected

Number of threats quarantined

Number of cookies scanned

Number of files scanned

Number of folders scanned

Note: for Bitdefender engine scans this is always 0 as Bitdefender does not scan by folder.

Number of registry entries scanned

Number of processes scanned

Number of scan errors

Note: for Bitdefender engine scans this is always 0.

Time taken to carry out scan in hours, minutes, and seconds.

This field is empty for scans that are still in progress.

Managed Antivirus engine where this data originates from, either VIPRE or Bitdefender (field only present where v>1)