Cisco DCNM provides REST APIs that allow third parties to test and develop application software. The REST API documentation is packaged with Cisco DCNM, and can be accessed through any browser.
Accessing the DCNM REST API documentation involves the following steps:
Log in to your Cisco DCNM Web Client.
Go to the URL: https://DCNM-IP/api-docs
The following figure shows the DCNM REST API documentation.
Figure 1. Cisco DCNM REST API Documentation
The Cisco DCNM REST API documentation only works with Cisco DCNM 10.2(1) or later releases.
The REST API documentation packaged with the Cisco DCNM 10.4(2) WebClient is limited to the following API categories:
The APIs are grouped under broad categories, such as, DCNM PMN Host management and DCNM Session Management. In the DCNM RestFul API document, click the Show/hide button corresponding to any of the API category names displayed on the page. Alternatively, click on any category link to expand or collapse it. When a category is expanded, you can see the corresponding APIs under it. The following figure shows the APIs in the DCNM Inventory category.
Figure 2. APIs in the DCNM Inventory Category
There are 4 types of API methods:
• GET—Fetch existing information or data from the DCNM server.
• POST—Create new information or data.
• DELETE—Delete existing information or data.
• PUT—Update existing information or data.
The following figure shows how the GET API method is used:
Figure 3. GET API Method
The following figure shows the response of the GET API method:
Figure 4. Response of GET API Method
For more information about the Cisco DCNM REST APIs, see https://developer.cisco.com/site/data-center-network-manager/?version=10.4(2)