Mapping for the BMC Discovery formats
The topics in this section describe the mapping for the BMC Discovery (formerly known as BMC Atrium Discovery and Dependency Mapping or BMC Atrium Discovery) formats.
BMC Discovery 11.0 and later (REST API) format
BMC Discovery versions 11.0 and later (specified as 11.0+ in the GUI) use the REST API to perform the import task, unlike earlier device imports.
Enter these details in the REST API Access fields.
- URL: Format the URL in the following format: https://Discovery_Server:port/api/v1.0/data/search
- User Name: Discovery UserName
- Password: password
- Query Parameter Name: query
- Query Parameter Value: search NetworkDevice show name,#InferredElement:Inference:Associate:DiscoveryAccess.endpoint, sysobjectid
Substitute the following values in the query URL:
The API call returns the following response:
{
"count": 2,
"headings": [
"name",
"#InferredElement:Inference:Associate:DiscoveryAccess.endpoint",
"sysobjectid"
],
"kind": "NetworkDevice",
"offset": 0,
"results": [
[
"bcan-cisco1200-01.bmc.com",
"172.19.216.22",
"1.3.6.1.4.1.9.1.525"
],
[
"bcan-cisco7010-01",
"172.19.216.68",
"1.3.6.1.4.1.9.12.3.1.3.612"
]
]
}
]
The results element contains the device details, such as device name, device address, and snmpoid.
BMC Discovery version 10.2, 11.0 and later (XML API) format
BMC Discovery versions 10.2, 11.0 and later (specified as 10.2 (XML API) and 11.0+ (XML API) in the GUI) use the XML API to perform the import task, unlike earlier device imports.
Format the URL as shown in the following example (all on a single line). Enter this URL on the import page into the Source field in the File Access section.
https://DISCOVERY_SERVER/ui/api/XmlApi?query=search NetworkDevice show name,#InferredElement:Inference:Associate:DiscoveryAccess.endpoint, sysobjectid&username=DISCOVERY_USERNAME&password=DISCOVERY_PASSWORD
Substitute the following values in the query URL:
The query returns the following values: