Catalyst SD-WAN vManage

This guide shows how to use the CiscoVmanage client to interact with Cisco SD-WAN vManage APIs.

It handles authentication, token refresh, and error management for you.

Connect to Cisco SD-WAN vManage

from wingpy import CiscoVmanage

vmanage = CiscoVmanage(
    base_url="https://vmanage.example.com/dataservice", # (1)!
    username="admin", # (2)!
    password="password", # (3)!
    verify=False,
)

1. Environment variable:

   WINGPY_VMANAGE_BASE_URL
   

2. Environment variable:

   WINGPY_VMANAGE_USERNAME
   

3. Environment variable:

   WINGPY_VMANAGE_PASSWORD
   

---

Get all

all_items = vmanage.get_all("")
for item in all_items:
    print(item["name"])

---

Get

rsp = vmanage.get("")
print(rsp.json())

---

Create

rsp = vmanage.post("")
print(rsp.status_code())

---

Replace

rsp = vmanage.put("")
print(rsp.status_code())

---

Update

rsp = vmanage.patch("")
print(rsp.status_code())

---

Remove

rsp = vmanage.delete("")
print(rsp.status_code())

---

• Authentication and token refresh are handled automatically, but you can call .authenticate() to force re-authentication.