Listing Agentless Assets

Base URL

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_agentless_assets

Description

Lists all agentless and mini-agent asset devices for site (including top level asset information).

Note: The agentless assets feature is deprecated.

Parameters

Required parameters

Add required parameters immediately after the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_agentless_assets&required_parameters={parameter-value}

Parameter	Description	Type	Options	Default
siteid	The siteid must be a valid id.	integer	0	0

Optional parameters

Add optional parameters after the required parameters in the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_agentless_assets&required_parameters={parameter-value}&optional_parameters={parameter-value}

Parameter	Description	Type	Options	Default
describe	Optional. Returns a description of the entered call, the available parameters, an example of its output, and returned fields with descriptions.	boolean	true	0

Determine parameter values

Use the following associated service calls to determine parameter values.

Parameter	Call	URL Format
siteid	list_sites	https://{SERVER}/api/?apikey={yourAPIkey}&service=list_sites&clientid={clientId value}
clientid	list_clients	https://{SERVER}/api/?apikey={yourAPIkey}&service=list_clients

Examples

List agentless assets for a site

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_agentless_assets&siteid=SITEID

Example response

<?xml version="1.0"?>
<result created="2009-09-24T16:41:12+01:00" host="SERVER" status="OK">
<items>
   <workstation>
    <guid></guid> 
    <name>PETE-LAPTOP</name> 
    <description>76508TG</description> 
    <install_date>2009-07-10</install_date> 
    <last_boot_time /> 
    <dsc_active>1</dsc_active> 
    <atz_dst_date>0000-03-05:00T01:00:00</atz_dst_date> 
    <utc_apt /> 
    <utc_offset>0</utc_offset> 
    <user>SERVER\peter </user> 
    <domain>test.local</domain> 
    <manufacturer>LENOVO</manufacturer> 
    <model>76508TG</model> 
    <ip>192.168.201.66</ip> 
    <external_ip>101.101.101.101</external_ip>
    <mac1>00:1C:BF:3D:03:AD</mac1> 
    <mac2>00:15:58:CC:D0:FE</mac2> 
    <mac3>18:E0:20:52:41:53</mac3> 
    <os>Microsoft Windows </os> 
    <workstationid>38549</workstationid> 
    <agent_version>6_0_0</agent_version> 
    <agent_mode>3</agent_mode> 
    <online>1</online> 
    <active_247>0</active_247> 
    <check_interval_247>60</check_interval_247> 
    <status_247>5</status_247> 
    <local_date_247>2009-07-15</local_date_247> 
    <local_time_247>09:16:00</local_time_247> 
    <utc_time_247>2009-07-10 10:36:00</utc_time_247> 
    <dsc_hour>6</dsc_hour> 
    <dsc_status>1</dsc_status> 
    <dsc_local_date>2009-07-15</dsc_local_date> 
    <dsc_local_time>09:16:00</dsc_local_time> 
    <dsc_utc_time>2009-07-10 10:36:00</dsc_utc_time> 
    <tz_bias /> 
    <tz_dst_bias /> 
    <tz_std_bias /> 
    <tz_mode /> 
    <tz_dst_date>0000-03-05:00T01:00:00</tz_dst_date>
    <tz_std_date>0000-10-05:00T02:00:00</tz_std_date>
    <assetid>53614</assetid> 
    <wins_name>PETE-LAPTOP</wins_name> 
    <role>1</role> 
    <chassis_type>10</chassis_type> 
    <device_serial>L3G4568</device_serial> 
    <processor_count>1</processor_count> 
    <total_memory>3221225472</total_memory> 
    ;<os_type>18</os_type>
    <service_pack>3</service_pack> 
    <os_serial_number>12345-OEM-00123456-00123</os_serial_number> 
    <os_product_key>ABCD1-EFG2H-IJ2KLM-NO3PQ-RSTUV</os_product_key> 
    <last_scan_time>2009-07-10 10:36:00</last_scan_time> 
    <custom field name> custom value </custom fieldname>
   </workstation>
   ..... more <server> nodes ...
  </items>
</result>
   ..... more workstation nodes ...
</items>
</result>

Returned fields

Field	Type	Can Be Empty	Description
assetid	integer	no	Unique identifier of asset
wins_name	string	yes	The WINS name of the physical asset.
user	string	yes	The user logged onto the physical asset during scan.
domain	string	yes	The domain the physical asset is a member of.
role	string	yes	The role being performed by physical asset: 0, 1: Windows Workstation 2, 3, 4, 5: Windows Server 101: UNIX/Linux 102: Mac 103: Printer 104: Router 105: NAS 106: Other Network Device other: Unknown
chassistype	integer	yes	Chassis type (physical workstations only): 8, 9, 10, 11, 14: laptop other: desktop
manufacturer	string	yes	The manufacturer of the physical asset.
model	string	yes	The model of the physical asset.
deviceserial	string	yes	The serial number of the physical asset.
ip	string	yes	The IP address of the physical asset.
mac1	string	yes	The MAC address of the first NIC in the physical asset.
mac2	string	yes	The MAC address of the second NIC in the physical asset.
mac3	string	yes	The MAC address of the third NIC in the physical asset.
processorcount	integer	yes	The number of processors in the physical asset.
totalmemory	integer	yes	The total memory (bytes) in the physical asset.
os	string	yes	The operating system installed on the physical asset.
servicepack	float	yes	The service pack installed on the physical asset.
osserialnumber	string	yes	The operating system serial number.
osproductkey	string	yes	The operating system product key.
lastscantime	datetime	no	The date and time of last asset scan.
custom field name	string	yes	The information entered in the Custom Field.