Listing Servers

Service name: list_servers

https://SERVER/api/?apikey=yourAPIkey&service=list_servers

&required_parameters=required_parameters

[&optional_parameters=optional_parameters]

Lists all server monitoring devices for site (including top level asset information if available).

Parameters

Default

0

0

Example Service Call =list_sites

https://SERVER/api/?apikey=yourAPIkey&service=list_servers&siteid=SITEID

Example Response

<?xml version="1.0" ?> 
 <result created="2015-07-20T14:02:22+01:00" host="SERVER" status="OK">
  <items>
   <server>
    <guid>94c8a376c690d94b73e66af3651866f4</guid> 
    <name>TANJA-DESKTOP</name> 
    <description>testing</description> 
    <install_date>2009-09-01</install_date> 
    <last_boot_time>1252483346</last_boot_time> 
    <dsc_active>1</dsc_active> 
    <atz_dst_date>0000-03-05:00T01:00:00</atz_dst_date> 
    <utc_apt>2015-07-20 16:11:48</utc_apt> 
    <utc_offset>-3600</utc_offset> 
    <user>SERVER\tanja </user> 
    <domain>test.local</domain> 
    <manufacturer>Dell Inc.</manufacturer> 
    <model>Vostro 220 Series</model> 
    <ip>192.168.200.42</ip> 
    <external_ip>101.101.101.101</external_ip>
    <mac1>00:21:9B:16:ED:72</mac1> 
    <mac2 /> 
    <mac3 /> 
    <os>Microsoft Windows Server 2016 Standard</os> 
    <os_details>Microsoft Windows Server 2016 Standard 64-bit (build 14393)</os_details> 
    <serverid>49324</serverid> 
    <agent_version>8_0_1</agent_version> 
    <agent_mode>0</agent_mode>
    <online>0</online> 
    <active_247>1</active_247> 
    <check_interval_247>5</check_interval_247> 
    <status_247>1</status_247> 
    <local_date_247>2009-09-09</local_date_247> 
    <local_time_247>17:11:48</local_time_247> 
    <utc_time_247>2009-09-09 16:11:50</utc_time_247> 
    <dsc_hour>6</dsc_hour> 
    <dsc_status>5</dsc_status> 
    <dsc_local_date>2009-09-09</dsc_local_date> 
    <dsc_local_time>09:09:36</dsc_local_time> 
    <dsc_utc_time>2009-09-09 08:09:37</dsc_utc_time> 
    <miss_factor_247>1.50</miss_factor_247> 
    <email_overdue_alert>1</email_overdue_alert> 
    <sms_overdue_alert>0</sms_overdue_alert> 
    <missed_247>0</missed_247> 
    <remote_connection_type>0</remote_connection_type> 
    <remote_address /> 
    <remote_port>0</remote_port> 
    <remote_username /> 
    <remote_domain /> 
    <tz_bias>0</tz_bias> 
    <tz_dst_bias>-60</tz_dst_bias> 
    <tz_std_bias>0</tz_std_bias> 
    <tz_mode>2</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>59740</assetid> 
    <wins_name>TANJA-DESKTOP</wins_name> 
    <role>1</role> 
    <chassis_type>3</chassis_type> 
    <device_serial>DSLL74J</device_serial> 
    <processor_count>1</processor_count> 
    <total_memory>4294967296</total_memory> 
    <os_type>18</os_type> 
    <service_pack>1</service_pack> 
    <os_serial_number>12345-OEM-5678910-00012</os_serial_number> 
    <os_product_key>123A4-56BCD-EFGHI-7J8KL-MRNO9</os_product_key> 
    <last_scan_time>2015-07-19 10:52:00</last_scan_time> 
     <custom field name> custom value </custom fieldname>
   </server>
   ..... more <server> nodes ...
  </items>
</result>
					

Fields Description

Description

Unique identifier of the monitored server.

The guid the monitored server uses to authenticate.

The name given to the monitored server.

The description of the monitored server.

The version of the Advanced Monitoring Agent installed on monitored server.

The date the Advanced Monitoring Agent was installed on the monitored server.

Timestamp of the last boot time of the monitored server.

Is server online or offline?

Are 24x7 checks running on server?

Interval for 24x7 checks (minutes)

Status of 24x7 checks:

Date (on server) of last 24x7 Checks upload.

Time (on server) of last 24x7 Checks upload.

UTC date and time of last 24x7 Checks upload.

Are Daily Safety Checks running on server?

Agent Mode:

Hour of day Daily Safety Checks are running.

Status of DSC checks:

Date (on server) of last Daily Safety Checks upload.

Time (on server) of last Daily Safety Checks upload.

UTC date and time of last Daily Safety Checks upload.

Number of 24x7 check intervals without data before marking server as overdue.

Send email alert if server goes overdue?

Send SMS alert if server goes overdue?

Has the server been marked as overdue?

The type of remote desktop connection saved for server:

The hostname or IP address for remote desktop connection saved for server.

The port used to connect to server saved in remote desktop connection saved for server.

The username used to authenticate saved in remote desktop connection saved for server.

The domain used to authenticate saved in remote desktop connection for server.

The offset in minutes from UTC time

The daylight saving time offset in minutes

The standard time offset in minutes

The current time zone mode:

The date when daylight saving time begins

The date when daylight saving time begins

The date when standard time begins

The Agent perceived UTC time

The effective UTC offset in seconds

The servers unique physical asset identifier

The WINS name of the physical asset.

The user logged onto the physical asset during scan.

The domain the physical asset is a member of.

The role being performed by physical asset:

Chassis type (physical workstations only):

The manufacturer of the physical asset.

The model of the physical asset.

The serial number of the physical asset.

The IP address of the physical asset.

The external IP address of the last agent upload.

The MAC address of the first NIC in the physical asset.

The MAC address of the second NIC in the physical asset.

The MAC address of the third NIC in the physical asset.

The number of processors in the physical asset.

The total memory (bytes) in the physical asset.

Type of operating system installed.

The operating system installed on the physical asset. Returns device.osversion if no as_device record.

The service pack installed on the physical asset.

The operating system serial number.

The operating system product key.

The date and time of last asset scan.

The information entered in the Custom Field