Inventory Scan Computers


This API lists all the computers and their related scan details.

  • Functionality
  • Retrieve the inventory computers list.
  • HTTP Method 
  • GET
  • API URI
  • api/1.3/inventory/scancomputers
  • Auth Token Required
  • Yes
  • Paginated
  • Yes
  • Filters
  • domainfilter={String}:

    Get domain list from api/1.3/desktop/serverproperties

    branchofficefilter={String}:

    Get branch office list from api/1.3/desktop/serverproperties

    residfilter={Numeric}:

    Filter computer with particular resource id

    livestatusfilter={Numeric}:

    1    -    Live
    2    -    Down
    3    -    Unkown

    scanstatusfilter={Numeric}:

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

    installstatusfilter={Numeric}:


    -1   -    Not done
    0    -    failed
    1    -    In progress
    2    -    success
    installstatusfilter={Numeric}:


    -1   -    Not done
    0    -    failed
    1    -    In progress
  • Response Parameters
  • live_status:

    1    -    Live
    2    -    Down
    3    -    Unkown
    installation_status:

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

    scan_status :

    -1   -    Not done
    0    -    failed
    1    -    In progress
    2    -    success
     

Response Data


{
"message_response": {
"total": 1,
"limit": 25,
"page": 1,
"scancomputers": [
{
"computer_live_status": 1,
"os_platform": 1,
"scan_remarks": "dc.common.SCANNING_COMPLETED",
"build_number": "7601",
"agent_installed_dir": "C:\Program Files (x86)\DesktopCentral_Agent\",
"scan_status": 2,
"agent_logged_on_users": "Administrator,admin",
"computer_status_update_time": 1450764296972,
"service_pack": "Service Pack 1",
"scan_remarks_en": "Scanning Completed",
"agent_last_contact_time": 1450417170806,
"process_start_time": 1450250502153,
"error_kb_url": "--",
"status_label": "dc.db.som.status.installed_successfully",
"branch_office_name": "Intern Ds Remote",
"last_sync_time": 1450767897942,
"process_end_time": 1450286646061,
"agent_installed_on": 1449570068627,
"os_version": "Windows 7 SP1 (x64)",
"last_successful_scan": 1450286646061,
"installation_status": 22,
"mac_address": "e8:9a:8f:3f:60:c8",
"resource_id": 313,
"domain_netbios_name": "DESKTOPCENTRAL",
"ip_address": "172.21.109.234",
"agent_version": "9.1.109.W",
"resource_name": "DC-W7-5",
"service_pack_minor_version": 0,
"software_name": "Windows 7 Professional Edition (x64)",
"service_pack_major_version": 1
}
]
},
"status": "success",
"message_version": "1.0",
"message_type": "scancomputers"
}