Giter Club home page Giter Club logo

postman-for-alwayson-cisco-sd-wan's Introduction

Postman for Cisco SD-WAN

This public repo contains a POSTMAN environment and collection that can be used to interact with the Cisco SD-WAN vManage REST API. The environment is pre-configured to access the Cisco DevNet Always On Sandbox for SD-WAN fabric. You can edit the variables in the environment to point to your own vManage instance.

Sandbox Image

API Calls in this Collection

This collection only includes calls to read (GET) information from the environment. It does not write changes to the vManage environment. The collection provides the following REST API calls to:

  • Authenticate
    • Credentials provided in the environment are for the Always On environment.
      • After authenticating with a username and password, another request is required to obtain a X-XSRF-TOKEN to protect against Cross-Site Request Forgery. When using this collection the token is automatically stored in a postman environment variable and used with further requests.
  • List devices that are part of the SD-WAN fabric and show device status, counters, and interface statistics for all the interfaces in the fabric.
  • List device templates
  • List device policy
  • Bulk API requests:
    • State Bulk State API Documentation
      • Includes an undocumented endpoint (/dataservice/data/device/state/CEdgeInterface) for obtaining a list of all interfaces on Cisco IOS XE Routers including i.e. Cisco ISR and also cloud hosted CSR devices.
    • Statistics Bulk Statistics API Documentation
      • Data lags real-time by ~20mins
  • Real-Time monitoring Real-Time Monitoring API Documentation

Feel free to modify them as you see fit and to add more calls to the collection.

Requirements

The Postman collection and environment will need:

  • Postman 6.4.4+
  • Cisco SD-WAN vManage 19.2.2 +

Setup

If you don't have Postman already installed, you can download it from here. Once you install it, you can follow the steps below to import the collection and environment:

Postman Image

  1. Click on Import, browse to the location where you cloned this repo and add the two files:
    1. Cisco-AlwaysOn-SD-WAN-Env.postman_environment
    2. Cisco-AlwaysOn-SD-WAN.postman_collection.json
  2. Make sure you select the Cisco-AlwaysOn-SD-WAN-Environment environment
  3. Expand the collection and start making REST API calls.

Using self-signed certificate

In case your instance of vManage has a self signed certificate, you can disable SSL certificate verification in Postman's settings. To disable SSL certificate verification go to Settings, click on switcher as in the screenshot below:

SSL certificate verification

About me

Network Automation Developer Advocate for Cisco DevNet. I'm like Hugh Hefner... minus the mansion, the exotic cars, the girls, the magazine and the money. So basically, I have a robe.

Find me here: LinkedIn / Twitter

postman-for-alwayson-cisco-sd-wan's People

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.