Get the results of discovered devices

Use this API to get the results of discovered devices for a discovery task, such as whether succeeded to get the config of a device.

Resource Information

Method

URL

Required authentication

GET

/V1/CMDB/Discovery/Tasks/{task}/Results

Yes

Parameters

Name

Description

Token*required
(header)

Place the token received from the API Log in to get an authentication token.

task*required
(path)

Input the name or ID of the scheduled discovery task added on benchmark page. Get a task ID by using the API Get all discovery tasks in a domain.

IPs
(query)

The list of IPs of discovered devices. Returns results of all devices if not specified.

Response

Parameter

Type

Description

Example

Devices

list

A list of discovered devices.

{
  "statusCode"790200,
  "statusDescription""success",
  "devices": [
    {
      "domainId""5e75247a-309c-4231-96a5-823b6cb1e78d",
      "source""Scan 172.24.101.12/32",
      "hostname""Bos-Core1",
      "frontServer""10.10.1.43",
      "ping""Succeeded",
      "SNMP""nb",
      "vendor""Cisco",
      "oid""1.3.6.1.4.1.9.1.324",
      "type""Cisco IOS Switch",
      "config""Succeeded",
      "telnetSSH""Succeeded"
    }
  ]
}

domainId

string

The ID of the domain that a device belongs to.

source

string

The IP from which a device was discovered.

hostname

string

The hostname of a device.

frontServer

string

The Proxy Server used to discover a device.

ping

string

The ping to a device succeeded or failed.

SNMP

string

The SNMP community string of a device.

vendor

string

The vendor of a device.

oid

string

The OID of a device.

type

string

The type of a device.

config

string

Obtaining device configuration succeeded or failed.

telenetSSH

string

Accessing a device via SSH or Telnet succeeded or failed.

statusCode

integer

The returned status code of executing the API.

statusDescription

string

The explanation of the status code.