Demystifying Cisco SD-WAN

APIs to Automate Cloud

OnRamp for Multi-Cloud

Diptish Doshi, Technical Marketing Engineer

DEVNET-2096
Cisco Webex App

Questions?
Use Cisco Webex App to chat
with the speaker after the session

How
1 Find this session in the Cisco Live Mobile App
2 Click “Join the Discussion”
3 Install the Webex App or go directly to the Webex space Enter your personal notes here

4 Enter messages/questions in the Webex space

Webex spaces will be moderated

until February 24, 2023.

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 2
 • WW(What & Why) of vManage APIs
• vManage API Categories
Agenda • Cloud OnRamp for Multi-Cloud APIs
• Demo

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 3
WW(What & Why)
of vManage APIs
vManage REST APIs
• vManage uses REST architecture which is
stateless, client–server, cacheable 3rd Party Applications

communications protocol. vManage REST APIs & Webhooks

• vManage exposes REST APIs and webhooks

to integrate with 3rd party systems vManage

• vManage uses NetConf for configuring and

managing edge devices NetConf

XE-SDWAN
vEdge
(cEdge)

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 5
vManage – Using REST APIs

• API Documentation built-in – https://<vmanage-ip:port>/apidocs

• Test API calls can be tried out from swagger UI
• API Documentation: https://developer.cisco.com/docs/sdwan/

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 6
 URI Structure
https://vmanage-ip:port/dataservice/device/bfd/state/device?deviceId=1.1.1.7

Server or Host Resource Parameters

https:// Resource
• Protocol over which data is sent • The location of the data or object of
between client and server interest
Server or Host Parameters
• Resolves to the IP and port to which to • Details to scope, filter, or clarify a
connect request. Often optional.

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 7
Options for Working with REST APIs
curl
• Linux command line application

Postman
• API testing application and framework

Requests
• Python library for scripting

Python Viptela SDK

OpenAPI/Swagger

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 8
vManage API
Categories
API categories
• vManage APIs are grouped into different resource collections as below
• APIs under each resource collection are documented at “https://<vmanage-
ip:port>/apidocs”

Device Action Multi Cloud

Device Inventory Administration

Configuration Monitoring

Certificate Management Real-Time Monitoring

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 10
Cloud OnRamp for
Multi Cloud APIs
 Cloud OnRamp for Multi Cloud APIs
SD-WAN via VPN Attachment

Host VPC1

AZ1
Transit VPC
VPC Attachment

AZ2

VPN Attachment
SD-WAN
Host VPC2

AZ1
AWS Transit
Gateway

AZ2

Breakout Session: BRKENT-2060 - Cisco SD-WAN Cloud OnRamp for Multicloud - from Connectivity to Application Integration

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 12
Demo
Additional Resources –
GitHub Repos and DevNet Learning Labs
• https://github.com/suchandanreddy/devnet2096
• https://github.com/CiscoDevNet/python-viptela
• https://github.com/suchandanreddy/sdwan-apis
• https://github.com/suchandanreddy/sdwan-umbrella-policy/
• https://github.com/suchandanreddy/sdwan-webhooks
• https://developer.cisco.com/sdwan/
• https://developer.cisco.com/learning/modules/sd-wan

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 14
DevNet Tools & Resources
• SD-WAN DevNet Learning Labs
• SD-WAN DevNet Sandboxes

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 15
 • Visit the Cisco Showcase
for related demos

• Book your one-on-one

Meet the Engineer meeting

• Attend the interactive education

with DevNet, Capture the Flag,
Continue and Walk-in Labs

your education • Visit the On-Demand Library

for more sessions at
www.CiscoLive.com/on-demand

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 16
Complete your Session Survey
• Please complete your session survey
after each session. Your feedback
is important.
• All surveys can be taken in the Cisco Events Mobile App or
by logging in to the Session Catalog and clicking the
"Attendee Dashboard” at
https://www.ciscolive.com/emea/learn/sessions/session-catalog.html

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 17
Continue
Agenda Your Education

Visit the Cisco Showcase for related demos.

Book your one-on-one Meet the Engineer meeting.

Attend any of the related sessions at the DevNet,

Capture the Flag, and Walk-in Labs zones.

Visit the On-Demand Library for more sessions

at ciscolive.com/on-demand.

DEVNET-2096 © 2023 Cisco and/or its affiliates. All rights reserved. Cisco Public 18
Thank you