Get Discovery Results
get
/discovery/request/result/
Gets the result of a discovery request.
Request
There are no request parameters for this operation.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : DiscoveryResultResponse
Type:
objectThe discovery request results.
Show Source
Example:
{
"DiscoveryContexts":[
{
"DiscoveryContextID":"disco-01f107bd-655f-42e0-ae1c-ac4740e734e7",
"TimestampInitiated":1702214858,
"TimeValidS":1216,
"TimestampExpiration":1702214858,
"InventoryHandler":"inventory-engine-name",
"Request":{
"Configuration":{
"ForcedProtocolDiscovery":true,
"ContextExpiryTimeM":60,
"ICMPConfiguration":[
{
"Mode":1,
"Timeouts":10,
"Count":5,
"CascadeMs":5
}
],
"SNMPConfiguration":[
{
"Method":"BULK",
"IsTCP":false,
"Timeout":"5s",
"ExponentialTimeout":false,
"Retries":3,
"MaxOids":100,
"MaxRepetitions":50,
"NonRepeaters":1,
"CustomSNMPAccessProfiles":[
{
"Version":2,
"ProfileID":1,
"UUID":"df29b366-c3a4-4a89-8ec8-2f1527276c75",
"Priority":1,
"Port":161,
"MTU":1456,
"Auth":{
"Community":"public",
"Username":"user",
"AuthType":"AUTHPRIV",
"AuthPassphrase":"QXV0aFBhc3N3b3Jk",
"AuthProtocol":"SHA256",
"PrivPassphrase":"UHJpdlBhc3N3b3Jk",
"PrivProtocol":"AES",
"AuthEngineID":"80001adc802417e202b8613f5400000000"
}
}
]
}
],
"RESTConfiguration":[
{
"Url":"192.0.2.0",
"Protocol":"https",
"Port":8080,
"APIAccessID":"dGVzdA==",
"APIAccessKey":"dGVzdA==",
"APIType":"vmware"
}
]
},
"IPranges":[
"192.0.2.0/24",
"198.51.100.0-198.51.100.5"
],
"IPList":[
"203.0.113.0",
"203.0.113.1"
],
"Level":[
[
1,
2,
3
]
],
"InventoryEngine":"inventory-engine-name"
},
"ExecutionConfiguration":{
"ForcedProtocolDiscovery":true,
"ContextExpiryTimeM":60,
"ICMPConfiguration":[
{
"Mode":1,
"Timeouts":10,
"Count":5,
"CascadeMs":5
}
],
"SNMPConfiguration":[
{
"Method":"BULK",
"IsTCP":false,
"Timeout":"5s",
"ExponentialTimeout":false,
"Retries":3,
"MaxOids":100,
"MaxRepetitions":50,
"NonRepeaters":1,
"CustomSNMPAccessProfiles":[
{
"Version":2,
"ProfileID":1,
"UUID":"df29b366-c3a4-4a89-8ec8-2f1527276c75",
"Priority":1,
"Port":161,
"MTU":1456,
"Auth":{
"Community":"public",
"Username":"user",
"AuthType":"AUTHPRIV",
"AuthPassphrase":"QXV0aFBhc3N3b3Jk",
"AuthProtocol":"SHA256",
"PrivPassphrase":"UHJpdlBhc3N3b3Jk",
"PrivProtocol":"AES",
"AuthEngineID":"80001adc802417e202b8613f5400000000"
}
}
]
}
],
"RESTConfiguration":[
{
"Url":"192.0.2.0",
"Protocol":"https",
"Port":8080,
"APIAccessID":"dGVzdA==",
"APIAccessKey":"dGVzdA==",
"APIType":"vmware"
}
]
}
},
{
"DiscoveryContextID":"disco-9794ffd7-0cb3-4f90-a17f-be527c46753d",
"TimestampInitiated":1702214858,
"TimeValidS":3587,
"TimestampExpiration":1702214858,
"InventoryHandler":"inventory-engine-name",
"Request":{
"Configuration":{
"ForcedProtocolDiscovery":true,
"ContextExpiryTimeM":60,
"ICMPConfiguration":[
{
"Mode":0,
"Timeouts":3,
"Count":10,
"CascadeMs":10
}
],
"SNMPConfiguration":[
{
"Method":"BULK",
"IsTCP":false,
"Timeout":"10s",
"ExponentialTimeout":false,
"Retries":3,
"MaxOids":100,
"MaxRepetitions":50,
"NonRepeaters":1,
"CustomSNMPAccessProfiles":[
{
"Version":2,
"ProfileID":1,
"UUID":"ef29b365-d3a3-5a88-9ec7-3f1527276c74",
"Priority":1,
"Port":161,
"MTU":1456,
"Auth":{
"Community":"public",
"Username":"user",
"AuthType":"AUTHPRIV",
"AuthPassphrase":"QXV0aFBhc3N3b3Jk",
"AuthProtocol":"SHA256",
"PrivPassphrase":"UHJpdlBhc3N3b3Jk",
"PrivProtocol":"AES",
"AuthEngineID":"80002adc802417e202b8613f5400000000"
}
}
]
}
],
"RESTConfiguration":[
{
"Url":"192.0.2.0",
"Protocol":"https",
"Port":8081,
"APIAccessID":"dGVzdA==",
"APIAccessKey":"dGVzdA==",
"APIType":"vmware"
}
]
},
"IPranges":[
"192.0.2.0/24",
"198.51.100.0-198.51.100.5"
],
"IPList":[
"203.0.113.0",
"203.0.113.1"
],
"Level":[
[
1,
2,
3
]
],
"InventoryEngine":"inventory-engine-name"
},
"ExecutionConfiguration":{
"ForcedProtocolDiscovery":true,
"ContextExpiryTimeM":60,
"ICMPConfiguration":[
{
"Mode":1,
"Timeouts":10,
"Count":5,
"CascadeMs":5
}
],
"SNMPConfiguration":[
{
"Method":"BULK",
"IsTCP":false,
"Timeout":"10s",
"ExponentialTimeout":false,
"Retries":3,
"MaxOids":100,
"MaxRepetitions":50,
"NonRepeaters":1,
"CustomSNMPAccessProfiles":[
{
"Version":2,
"ProfileID":1,
"UUID":"ef29b365-d3a3-5a88-9ec7-3f1527276c74",
"Priority":1,
"Port":161,
"MTU":1456,
"Auth":{
"Community":"public",
"Username":"user",
"AuthType":"AUTHPRIV",
"AuthPassphrase":"QXV0aFBhc3N3b3Jk",
"AuthProtocol":"SHA256",
"PrivPassphrase":"UHJpdlBhc3N3b3Jk",
"PrivProtocol":"AES",
"AuthEngineID":"80002adc802417e202b8613f5400000000"
}
}
]
}
],
"RESTConfiguration":[
{
"Url":"192.0.2.0",
"Protocol":"https",
"Port":8081,
"APIAccessID":"dGVzdA==",
"APIAccessKey":"dGVzdA==",
"APIType":"vmware"
}
]
}
},
{
"DiscoveryContextID":"disco-b9389bf3-d51b-4957-b67f-d997a24faf10",
"ModelData":{
"Cisco":[
{
"TargetUrl":"https://api.example.com/api/v1/",
"Protocol":"https",
"Port":0,
"HostName":"api.example.com/api/v1/",
"IPAddress":"",
"ZoneID":1,
"APIAccessKey":"ZXhhbXBsZQ==",
"APIVersion":"",
"Discovered":true,
"APIError":false,
"ErrorMessage":"",
"PollTimeACOM":0,
"PollTimePCOM":0,
"MerakiDiscoveryData":{
"organizations":[
{
"id":"205211",
"name":"ACME",
"url":"https://n35.example.com/o/MciQXa/manage/organization/overview",
"networks":[
{
"id":"L_582653201791065564",
"organizationId":"205211",
"name":"DE-Dortmund Staging",
"timeZone":"GMT",
"tags":[
],
"productTypes":[
"appliance",
"camera",
"cellularGateway",
"sensor",
"switch",
"wireless"
],
"enrollmentString":"",
"networkDevices":[
{
"lat":0,
"lng":0,
"address":"",
"serial":"XXXX-XXXX-XXXX",
"mac":"FF:FF:FF:FF:FF:FF",
"url":"https://n35.example.com/DE-Dortmund-Stag/n/AN3a-bJ/manage/nodes/new_list/9834197920531",
"networkId":"L_582653201791065564",
"tags":[
],
"name":"",
"model":"MX95",
"firmware":"wired-19-1-6",
"floorPlanId":null,
"wan1Ip":"193.96.193.149"
}
],
"topology":{
"nodes":[
{
"derivedId":"9834197920531",
"mac":"FF:FF:FF:FF:FF:FF",
"type":"device",
"root":true,
"discovered":{
"lldp":{
"chassisId":"",
"systemName":"",
"systemDescription":"",
"systemCapabilities":null,
"managementAddress":""
},
"cdp":null
},
"stack":{
"id":"",
"name":"",
"clients":{
"counts":{
"total":0
}
}
},
"device":{
"serial":"XXXX-XXXX-XXXX",
"name":"",
"model":"MX95",
"productType":"appliance",
"status":"online",
"lastReportedAt":"2025-01-22T06:13:44Z",
"clients":{
"counts":{
"total":3
}
},
"uplinks":[
{
"vlanId":0,
"pppoe":{
"enabled":false
}
},
{
"vlanId":0,
"pppoe":{
"enabled":false
}
},
{
"vlanId":0,
"pppoe":{
"enabled":false
}
}
]
}
}
],
"links":[
],
"Devices":null
}
}
],
"devices":[
{
"address":"",
"configurationUpdatedAt":"2024-11-17T21:24:54Z",
"firmware":"wired-19-1-6",
"lat":0,
"lng":0,
"mac":"FF:FF:FF:FF:FF:FF",
"model":"MX95",
"name":"",
"networkId":"L_582653201791065564",
"productType":"appliance",
"serial":"XXXX-XXXX-XXXX",
"tags":[
],
"url":"https://n35.example.com/DE-Dortmund-Stag/n/AN3a-bJ/manage/nodes/new_list/9834197920531",
"wan1Ip":"193.96.193.149",
"sensor":{
"alertProfileIds":null,
"alertingOn":null,
"metrics":null
}
}
]
}
]
}
}
]
}
}
]
}Nested Schema : items
Type:
Show Source
object-
DiscoveryContextID: string
The discovery request ID.Example:
disco-01f107bd-655f-42e0-ae1c-ac4740e734e7 -
ExecutionConfiguration: object
ExecutionConfiguration
The configuration for running discovery.
-
InventoryHandler: string
The inventory handler name.Example:
inventory-engine-name -
Request: object
Request
The configuration provided for discovery.
-
TimestampExpiration: integer
Minimum Value:
0Maximum Value:9223372036854776000The unix time in seconds when the discovery expired.Example:1702214858 -
TimestampInitiated: integer
Minimum Value:
0Maximum Value:9223372036854776000The unix time in seconds when the discovery was initiated.Example:1702214858 -
TimeValidS: integer
Minimum Value:
0Maximum Value:9223372036854776000The number of seconds that the discovery is valid.Example:1216
Nested Schema : ExecutionConfiguration
Type:
objectThe configuration for running discovery.
Show Source
-
ContextExpiryTimeM: integer
Minimum Value:
0Maximum Value:2147483647The number of minutes the discovery is valid before expiring.Example:60 -
ForcedProtocolDiscovery: boolean
Allowed Values:
[ true, false ]Whether to enable every discovery protocol, regardless of ICMP results (true) or not (false). -
ICMPConfiguration: array
ICMPConfiguration
The ICMP configuration for discovery.
-
RESTConfiguration: array
RESTConfiguration
The REST configuration for discovery.
-
SNMPConfiguration: array
SNMPConfiguration
The SNMP configuration for discovery.
Nested Schema : Request
Type:
objectThe configuration provided for discovery.
Show Source
-
Configuration: object
Configuration
The ICMP, SNMP and REST configurations for discovery.
-
InventoryEngine: string
The inventory engine name.Example:
inventory-engine-name -
IPList: array
IPList
The list of IP addresses to perform discovery on.
-
IPranges: array
IPranges
The list of IP ranges to perform discovery on. Supports CIDR ranges.
-
Level: array
Level
The types of polling enabled for discovery. Possible values are 1 for ping, 2 for SNMP, and 3 for REST.
Nested Schema : ICMPConfiguration
Type:
arrayThe ICMP configuration for discovery.
Show Source
-
Array of:
object ICMPConfiguration
The ICMP payload configuration.
Nested Schema : RESTConfiguration
Type:
arrayThe REST configuration for discovery.
Show Source
-
Array of:
object RESTConfiguration
REST configurations for Cisco Meraki, Juniper MIST and VMWare connections.
Nested Schema : SNMPConfiguration
Type:
arrayThe SNMP configuration for discovery.
Show Source
-
Array of:
object SNMPConfiguration
The SNMP payload configuration.
Nested Schema : ICMPConfiguration
Type:
objectThe ICMP payload configuration.
Show Source
-
CascadeMs: integer
Minimum Value:
0Maximum Value:2147483647The number of milliseconds between two successful pings.Example:5 -
Count: integer
Minimum Value:
0Maximum Value:2147483647The number of ping requests to send.Example:5 -
Mode(required): integer
Allowed Values:
[ 0, 1 ]The ICMP mode. Possible values are 0 for synchronous and 1 for asynchronous.Example:1 -
Timeouts: integer
Minimum Value:
0Maximum Value:2147483647The number of milliseconds to wait for the ping message corresponding to a given ping message.Example:10
Nested Schema : RESTConfiguration
Type:
objectREST configurations for Cisco Meraki, Juniper MIST and VMWare connections.
Show Source
-
APIAccessID: string
The base64-encoded API access ID for the REST API URL.Example:
dGVzdA== -
APIAccessKey: string
The base64-encoded API access key for the REST API URL.Example:
ZXhhbXBsZQ== -
APIType(required): string
Allowed Values:
[ "vmware" ]The REST API type.Example:vmware -
Port: integer
Minimum Value:
0Maximum Value:65535The port number for the REST API URL.Example:8080 -
Protocol(required): string
Allowed Values:
[ "http", "https" ]The protocol used for the REST API.Example:https -
Url: string
The REST API URL for Meraki, VMWare or Mist.Example:
192.0.2.0
Nested Schema : SNMPConfiguration
Type:
objectThe SNMP payload configuration.
Show Source
-
CustomSNMPAccessProfiles: array
CustomSNMPAccessProfiles
The list of custom SNMP access profiles.
-
ExponentialTimeout: boolean
Allowed Values:
[ true, false ]The status is enabled to timeout exponentially if the request fails.Example:false -
IsTCP: boolean
Allowed Values:
[ true, false ]Whether SNMP is implemented over TCP (true) or not (false).Example:false -
MaxOids: integer
Minimum Value:
0Maximum Value:128The maximum SNMP OID value.Example:100 -
MaxRepetitions: integer
Minimum Value:
0Maximum Value:2147483647The maximum number of repetitions.Example:50 -
Method: string
Allowed Values:
[ "BULK", "GET" ]The SNMP method.Example:BULK -
NonRepeaters: integer
Minimum Value:
0Maximum Value:2147483647The number of non repeaters.Example:1 -
Retries: integer
Minimum Value:
0Maximum Value:2147483647The number of times to retry the request.Example:3 -
Timeout: string
Allowed Values:
[ "1s", "2m", "3h", "4d" ]The number of seconds, minutes, hours, or days before the request times out.Example:5s
Nested Schema : CustomSNMPAccessProfiles
Type:
arrayThe list of custom SNMP access profiles.
Show Source
-
Array of:
object CustomSNMPAccessProfile
A custom SNMP access profile.
Nested Schema : CustomSNMPAccessProfile
Type:
objectA custom SNMP access profile.
Show Source
-
Auth: object
CustomSNMPAccessProfileAuth
Custom SNMP access profile authentication information.
-
MTU: integer
Minimum Value:
0Maximum Value:2147483647The MTU for the custom SNMP access profile.Example:1456 -
Port: integer
Minimum Value:
0Maximum Value:65535The custom SNMP access profile port.Example:161 -
Priority: integer
Minimum Value:
0Maximum Value:2147483647The custom SNMP access profile priority.Example:1 -
ProfileID: integer
Minimum Value:
0Maximum Value:4294967295The custom SNMP access profile ID.Example:1 -
UUID: string
(uuid)
The custom SNMP access profile UUID.Example:
df29b366-c3a4-4a89-8ec8-2f1527276c75 -
Version(required): integer
Allowed Values:
[ 1, 2, 3 ]The custom SNMP access profile version.Example:2
Nested Schema : CustomSNMPAccessProfileAuth
Type:
objectCustom SNMP access profile authentication information.
Show Source
-
AuthEngineID: string
The custom SNMP access profile authentication engine ID.Example:
80001adc802417e202b8613f5400000000 -
AuthPassphrase: string
The custom SNMP access profile authentication passphrase.Example:
QXV0aFBhc3N3b3Jk -
AuthProtocol: string
The custom SNMP access profile authentication protocol.Example:
SHA256 -
AuthType: string
Allowed Values:
[ "NOAUTHNOPRIV", "AUTHNOPRIV", "AUTHPRIV" ]The custom SNMP access profile authentication type.Example:AUTHPRIV -
Community: string
The custom SNMP access profile community string.Example:
public -
PrivPassphrase: string
The custom SNMP access profile private passphrase.Example:
UHJpdlBhc3N3b3Jk -
PrivProtocol: string
The custom SNMP access profile private protocol.Example:
AES -
Username: string
The custom SNMP access profile user name.Example:
user
Nested Schema : Configuration
Type:
objectThe ICMP, SNMP and REST configurations for discovery.
Show Source
-
ContextExpiryTimeM: integer
Minimum Value:
0Maximum Value:2147483647The number of minutes the discovery is valid before expiring.Example:60 -
ForcedProtocolDiscovery: boolean
Allowed Values:
[ true, false ]Whether to enable every discovery protocol, regardless of ICMP results (true) or not (false). -
ICMPConfiguration: array
ICMPConfiguration
The ICMP configuration for discovery.
-
RESTConfiguration: array
RESTConfiguration
The REST configuration for discovery.
-
SNMPConfiguration: array
SNMPConfiguration
The SNMP configuration for discovery.
Nested Schema : IPList
Type:
arrayThe list of IP addresses to perform discovery on.
Show Source
Example:
[
"203.0.113.0",
"203.0.113.1"
]Nested Schema : IPranges
Type:
arrayThe list of IP ranges to perform discovery on. Supports CIDR ranges.
Show Source
Example:
[
"192.0.2.0/24",
"198.51.100.0-198.51.100.5"
]Nested Schema : Level
Type:
arrayThe types of polling enabled for discovery. Possible values are 1 for ping, 2 for SNMP, and 3 for REST.
Show Source
-
Array of:
integer
Allowed Values:
[ 1, 2, 3 ]Example:[ 1, 2, 3 ]
Nested Schema : ICMPConfiguration
Type:
arrayThe ICMP configuration for discovery.
Show Source
-
Array of:
object ICMPConfiguration
The ICMP payload configuration.
Nested Schema : RESTConfiguration
Type:
arrayThe REST configuration for discovery.
Show Source
-
Array of:
object RESTConfiguration
REST configurations for Cisco Meraki, Juniper MIST and VMWare connections.
Nested Schema : SNMPConfiguration
Type:
arrayThe SNMP configuration for discovery.
Show Source
-
Array of:
object SNMPConfiguration
The SNMP payload configuration.
401 Response
Unauthorized operation
500 Response
Internal server error