APIs for Cisco Catalyst Center and vManage

  • In the previous lesson on Cisco Catalyst Center, you saw the controller push config, read inventory, and run show commands on the devices.

    But how does communicate?
    It uses APIs in two directions: one going up to apps, one going down to devices.

    Catalyst Center stack: external apps above, controller in the middle, network devices below

    Figure 1 – sits between external apps (northbound) and network devices (southbound)

    Two directions, two jobs:

    • Northbound: apps talk to

    • Southbound: talks to the devices

    Northbound

    Northbound is the direction your scripts and tools use to reach .

    exposes a REST API that exchanges JSON over HTTPS.
    It uses standard verbs: GET to read, POST to create, PUT to update, DELETE to remove.

    Terminal sends a curl GET request to Catalyst Center, receives JSON in response

    Figure 2 – A script calls over HTTPS and gets JSON back

    Imagine your script needs the list of every switch in the network.
    Instead of opening SSH on each one, the script sends GET /dna/intent/api/v1/network-device and returns the inventory as JSON.

    That's the whole northbound idea: your script describes what it wants, figures out the how.

    Answer the question below

    Which encoding format do Catalyst Center northbound APIs use?

    Answer the question below

    Which API direction is used when a script asks Catalyst Center for the list of devices?

    Southbound

    Southbound is the direction uses to reach your devices.
    It does not invent a new protocol.

    It uses the ones your switches, routers, WLCs, and APs already understand.

    Catalyst Center reaches network devices via four southbound protocols: NETCONF, RESTCONF, SNMP, SSH

    Figure 3 – reaches the network through four southbound protocols

    speaks four southbound protocols:

    • NETCONF: structured config over SSH, XML payloads, models

    • RESTCONF: same models, but over HTTPS with JSON or XML

    • SNMP: for reading telemetry and inventory from devices

    • SSH: for pushing CLI commands when a device does not support or

    The first two are modern and structured.
    and SSH cover what these newer protocols can't reach.

    Answer the question below

    Which model-driven protocol does Catalyst Center use southbound over SSH?

    Answer the question below

    Which southbound protocol does Catalyst Center use to push CLI commands when a device does not support NETCONF or RESTCONF?