Cisco DevNet Series

Session 2: Introduction to Coding

Speaker: Matt Denapoli

Hostess: Kara Sullivan | Cisco Networking Academy
14 September 2017
 • Use the Q and A panel to ask
questions.
• Use the Chat panel to
communicate with attendees
Welcome to the and panelists.
2nd session of the • A link to a recording of the
Cisco DevNet session will be sent to all
webinar series registered attendees.
• Please take the feedback
survey at the end of the
webinar.

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 2
 Matt Denapoli
Joining Developer Evangelist
DevNet, Cisco

You
Giuseppe Cinque
Today: Manager for the Emerging
Technologies
NetAcad, Cisco

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 3
Next DevNet Session
THIRD SESSION:

Intent Networks
25 October – 9:00 A.M. PT
Register at: http://bit.ly/DevNetSession3
Intro to Coding
Giuseppe Cinque & Wadih Zaatar

Solutions & Marketing

September 2017
Telephone Car Rou
ter

The world is becoming connected and programmable

This is the Digital Transformation

You can ernoll today to learn more http://bit.ly/IntroIoT

WHERE THE NETWORK
IS PROGRAMMABLE
Module 01

Intro to Coding

Matthew DeNapoli
DevNet Developer Evangelist
Agenda

Getting Started

Learning APIC-EM
APIC-EM with Postman – HTTP Calls &
Generate Code
Calling APIC-EM REST APIs with Python

Q&A

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 10
Learning APIC-EM

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 11
APIC-EM Applications and Use Cases
• Easy QoS
• Application Priority
• Plug-n-Play
• Agent based control
• IWAN
• Policy based automated deployment
• Path Trace
• Path troubleshooting
 APIC-EM Uses REST
Easy to use:

• In mobile apps
• In console apps
• In web apps
Cisco APIC-EM REST APIs
• Hosts
• Devices
• Users
• + more
How does this work?

13
Anatomy of a REST Request
Method
– POST, GET, PUT, DELETE (CRUD)
URL
– Example: http://{APIC-EMController}/api/v1/host
Authentication
– Basic HTTP, OAuth, none, Custom
Custom Headers
– HTTP Headers
– Example: Content-Type: application/json
Request Body
– JSON or XML containing data needed to complete request

14
APIC-EM Example: Post Ticket
Application Policy Infrastructure Controller (APIC) Enterprise Module (EM)

POST http://{APIC-EMController}/api/v1/ticket
3rd Party
Request
App
Authorization Code returned in JSON

Response

15
APIC-EM Example: Get Host
Application Policy Infrastructure Controller (APIC) Enterprise Module (EM)

GET http://{APIC-EMController}/api/v1/host
3rd Party
Request
App
List of Hosts returned in JSON

Response

16
Using the API Reference Documentation
API Reference Guide Details
APIC-EM with Postman

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 19
https://www.getpostman.com
Postman
Create a ticket

method url

Request body

22
Header Specification

Header Key Header Value

23
Ticket Returned in Response Body

Response Ticket
(save this)

24
Use ticket in Header in all API Calls

Header Ticket

25
 APIC-EM – List of Hosts
URL

Method Header

Return Code

Response
Body

26
Using Postman to Generate Code
Selecting the Code to Generate
Generated Python Requests Code
REST Demo – Using Postman
Get Hosts
– Method: GET
– Headers: ‘X-Auth-Token’ (insert your ticket value)
– URL: http://<APIC-EMController>/api/v1/host

Get Devices
– Method: GET
– Headers: ‘X-Auth-Token’ (insert your ticket value)
– URL: http://<APIC-EMController>/api/v1/network-device

Get Users
– Method: GET
– Headers: ‘X-Auth-Token’ (insert your ticket value)
– URL: http://<APIC-EMController>/api/v1/user

30
APIC-EM with Python

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 31
First APIC-EM REST call from Python
import requests
import json
url = 'https://198.18.129.100/api/v1/ticket’
payload = {"username":“admin","password":"C1sco12345"}
header = {"content-type": "application/json”}
response= requests.post(url,data=json.dumps(payload), headers=header,
verify=False)

print(response.text)

32
Getting Ticket Function
apic_em_ip = "https://198.18.129.100/api/v1"

def get_token(url):
api_call = "/ticket"
payload = {"username": "admin", "password": "C1sco12345"}
headers = {"content-type": "application/json"}
url += api_call
response = requests.post(url, data=json.dumps(payload),
headers=headers, verify=False).json()

return response["response"]["serviceTicket"]
Getting Network Device ID/Config Functions
def get_device_id(token, url):
api_call = "/network-device"
headers = {"X-AUTH-TOKEN": token}
url += api_call
response = requests.get(url, headers=headers, verify=False).json()
for item in response['response']:
if item['role'] == 'ACCESS':
return item['id']
Q&A

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 35
This is the Digital Transformation

You can ernoll today to learn more http://bit.ly/IntroIoT

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 36
Next DevNet Session
THIRD SESSION:

Intent Networks
25 October – 9:00 A.M. PT
Register at: http://bit.ly/DevNetSession3