About the Cisco IMC XML API
The Cisco IMC XML API is a programmatic interface to the Cisco Integrated Management Controller (Cisco IMC) software for a C-Series Rack-Mount Server. The API accepts XML documents through HTTP or HTTPS. Developers can use any programming language to generate XML documents that contain the API methods. Configuration and state information for Cisco IMC is stored in a hierarchical tree structure known as the MIT (Management Information Tree), which is completely accessible through the XML API.
The Cisco IMC XML API implements a subset of the methods and management information model available in the Cisco UCS Manager XML API. The behavior of both APIs is similar in syntax and semantics, and you can use the same client development tools and techniques for both. The scope of the Cisco IMC XML API is limited to a single C-Series Rack-Mount Server, in contrast to the Cisco UCS Manager XML API, which controls an entire Cisco UCS domain consisting of switches, FEX modules, servers, and other devices.
Using the Cisco IMC XML API, the user has programmatic access to Cisco IMC to configure, administer, and monitor the server. The API provides most of the functions that are accessible through the Cisco IMC CLI and GUI interfaces.
Operation of the API is transactional and terminates on a single data model maintained in Cisco IMC.
The API model includes the following programmatic entities:
-
Classes—Define the properties and states of objects in the MIT.
-
Methods—Actions that the API performs on one or more objects.
-
Types—Object properties that map values to the object state (for example,
equipmentPresence
).
A typical request comes into Cisco IMC and is placed in the transactor queue in FIFO order. The transactor gets the request from the queue, interprets the request, and performs an authorization check. After the request is confirmed, the transactor updates the MIT. This complete operation is done in a single transaction.
Event subscription is supported. Up to four Cisco IMC XML API clients can subscribe to receive event notifications from Cisco IMC. The event subscription operation establishes a connection session allowing a client to receive XML-formatted event notification messages that are sent asynchronously by Cisco IMC.
Note |
In Release 1.5(1.x), the Cisco IMC XML API sends event notifications only for fault-related events. |