SoM Computers


This API lists all the computers and their related UEM central agent details

  • Functionality
  • Retrieve the som computers list.
  • HTTP Method 
  • GET
  • API URI
  • api/1.3/som/computers?customerid={customer_id}
  • Filters
  • domainfilter={String} :

    Get domain list from api/1.3/desktop/serverproperties?customerid={customer_id}

    branchofficeFilter={String}:

    Get branch office list from api/1.3/desktop/serverproperties?customerid={customer_id}

    residfilter={Numeric}:

    Filter computer with particular resource id
    liveStatusfilter={Numeric} :

    1    -    Live
    2    -    Down
    3    -    Unkown

    installstatusfilter={Numeric} :

    21    -    Yet to install
    22    -    Installed
    23    -    uninstalled
    24    -    yet to uninstall
    29    -    installation failure
  • Response Parameters
  • live_status:

    1    -    Live
    2    -    Down
    3    -    Unkown

    agent_install_status:

    21    -    Yet to install
    22    -    Installed
    23    -    uninstalled
    24    -    yet to uninstall
    29    -    installation failure

Response Data

 
{
"Status":"Success",
"MessageVersion":"1.3",
"MessageResponse":{
"computers":[
{
"remarks_args":"--",
"search_tag":"--",
"os_platform":1,
"location":"--",
"agent_uninstalled_on":-1,
"remarks":"dc.db.agent.install.success",
"logged_on_users":"CNETV",
"live_status_update_time":1432128262193,
"kb_url":"--",
"last_contact_time":1430770370570,
"service_pack":"Windows XP Service Pack 3",
"description":"--",
"name":"RC-9996",
"live_status":2,
"owner_email_id":"--",
"customer_name":"DC_CUSTOMER",
"label":"dc.db.som.status.installed_successfully",
"branch_office_name":"Local Office",
"last_sync_time":1445855012528,
"os_version":"5.1.2600",
"agent_installed_on":1428945129246,
"mac_address":"00:40:96:be:a4:af",
"installation_status":22,
"domain_netbios_name":"kamc-rd",
"resource_id":334,
"agent_version":"9.1.0.W",
"ip_address":"10.3.9.83",
"os_name":"Windows XP Professional",
"agent_executed_on":1430743370614,
"os_platform_name":"Windows",
"owner":"--",
"agent_upgraded_on":-1,
"customer_id":1,
"full_name":"RC-9996"
}
],
"Page":1,
"Total":1,
"Limit":25
},
"MessageType":"computers"
}