Cisco SD-WAN REST API
Cisco SD-WAN vManage provides a REST API interface and its functionality over REST API. The REST API documentation for cisco vManage can be found at the following link: https://sdwan-docs.cisco.com/Product_Documentation/Command_Reference/Command_Reference/vManage_REST_APIs
A Swagger based documentation is also provided at the following URL:
This documentation gives you the option of interacting with the API and to see how the schema of the API is organized.
Explore the API by trying out some REST calls in the swagger interface. The username is admin and password is admin.
Monitoring – Device Details
try out the GET call for the /device endpoint that can be found under Monitoring – Device Details.
Click on /devices
the output will be as below
Click on Try it out
You will see request URL created for Rest API call to get devices details
the following output shows the Response Body and Response Header received for this request.
Response code 200 means success.
The output will be in JSON format as seen below:
We can see that the output of this call is verbose and contains a lot of useful information.
Monitoring – Device Config
try out the GET call for the /device config that can be found under Monitoring – Device Details.
For the deviceId parameter give the ip address of device that we want to monitor.
We will use IP address of our vManage device to monitor its configuration.
In this example we will use the web browser to send rest api get request.
Type following request on your browser
section We can see that the output of this call is verbose and contains a lot of useful information.