Listing Agentless Assets
Use this API Call to query our Data Extraction API to extract data gathered by N-sight RMM.This section shows the service name and parameters needed in the API Call query, and provides examples of some queries and system responses. For more information, see Data Extraction API.
Service name: list_agentless_assets |
|
URL |
https://SERVER/api/?apikey=yourAPIkey&service=list_agentless_assets &required_parameters=required_parameters [&optional_parameters=optional_parameters] |
Description |
Lists all agentless and mini-agent asset devices for site (including top level asset information) Please be aware that agentless assets is a deprecated feature. |
Parameters |
|||||
Post Variable |
Description |
Type |
Required |
Options |
Default |
Optional. Returns a description of the service. |
boolean |
no |
true |
0 |
|
siteid |
The siteid must be a valid id. |
integer |
yes |
0 |
0 |
Example Service Call =list_agentless_assets |
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> |
Fields Description |
|||||||||||||||||||||
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:
|
||||||||||||||||||
chassistype |
integer |
yes |
Chassis type (physical workstations only):
|
||||||||||||||||||
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 |
Example Associated Service Calls | ||
Parameter | Call | URL Format |
SiteID | list_sites | https://SERVER/api/?apikey=yourAPIkey&service=list_sites&clientid=CLIENTID |
ClientID | list_clients | https://SERVER/api/?apikey=yourAPIkey&service=list_clients |