Coding 102: REST API Basics using APIC-EM

Coding 102 - REST API Basics using APIC-EM

Brett Tiller Developer EvangelistDEVNET-2003

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public

• Intended Audience• DNA• Coding 101 Recap• Lab Set up• Let’s Write Some Python!• Final Thoughts

Agenda

DEVNET-2003 2


Intended Audience

DEVNET-2003 3

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public 4

Who is Coding 102 for?

New coders

Returning coders

NetOps

DevOps

DEVNET-2003


DNA

DEVNET-2003 5


APIC-EM

DEVNET-2003 7


Coding 101 Recap

DEVNET-2003 8


Coding 101 Recap• REST

• HTTP

• CRUD

• POST, GET, PUT, DELETE

• JSON• Java script Object Notation

• food={“vegetables”:[“carrots”,“kale”,“cucumber”,”tomato”]}

• Postman• HTTP Client

• Python

DEVNET-2003


Lab Set up

DEVNET-2003 10


Put these URLs in a text document

https://learninglabs.cisco.com

https://github.com/CiscoDevNet

http://www.python.org

http://www.getpostman.com

http://www.git-scm.com

DEVNET-2003


Set up : Tools Python 3.4+

https://www.python.org/downloads/release/python-351/ Checking python version: Open your laptop on command line type:

Command: python –V

Install Python Requests Module Command: pip install requests

Http Client - Postman Install/Use Chrome Browser Postman REST Client -- http://www.getpostman.com/

DEVNET-2003

https://www.python.org/downloads/release/python-351/

http://www.getpostman.com/


Set up : Tools (Continued) Editor

A capable text editor or Integrated Development Environment Notepad ++ VI Eclipse with PyDev Plugin PyCharm WingIDE

DEVNET-2003


• On your desktop open a command terminal.

• Go to the root directory by typing: cd \• Create a directory called 'C:\DevNetCode\yourname' by typing: mkdir

DevNetCode\<your-name>• For example: mkdir DevNetCode\brtiller• Go to the new directory by typing: cd \DevNetCode\<your-name>• For example: cd \DevNetCode\brtiller

Create your Source Code Directory

14DEVNET-2003


Set up : Download Sample Code Get Source code

https://github.com/CiscoDevNet/coding-skills-sample-code

To clone repository locally run the following command: git clone https://

github.com/CiscoDevNet/coding-skills-sample-code.git

Or get code via download https://github.com/CiscoDevNet/coding-skills-sample-code

Click ‘Clone or download’ Click ‘Download Zip’ Copy file to your directory C:\DevNetCode\<your name> Unzip

DEVNET-2003




https://github.com/CiscoDevNet/coding-skills-sample-code.git

https://github.com/CiscoDevNet/coding-skills-sample-code.git





Follow along with the Learning Lab

• Login with DevNet/Cisco.com ID• Coding 101 Lab – REST Basics• Coding 102 Lab - Calling REST APIs with Pythons

• How to Set up Your Own Computer

https://learninglabs.cisco.com

DEVNET-2003 16


Disclaimer: Sample Code vs. Real Code

• The examples and code in this presentation are for Learning and Educational purposes.

• The samples were created with the goals of clarity and ease of understanding.

• If you are writing code for a real application, you would write the code in a more efficient and structured style.

DEVNET-2003

© 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public 18DEVNET-2003

Python Introduction


Running Python and scripts Running Python 3: Checking your version

python -V or py -3 -V [ Windows] python3 –V [ Linux, OS X]

Running a python script python script.py or py -3 script.py [ Windows] python3 script.py [ Linux, OS X]

Running Python Interpreter on the Command line python or py -3 [ Windows] Python3 [ Linux, OS X] To exit: Type quit() or Ctrl Z

DEVNET-2003


Python Syntax, Data Types, Loops …Etc Indentation defines scope

Python code blocks do not have explicit statement scope delimiters Indentation amount is relative

Data Types Statements

Import Print Conditional Looping Functions

DEVNET-2003


Python Indentation

21

print ("Hello World!")

num = 1

if num < 1:

print ("I'm less than 1!")

print ("Goodbye Cruel World!")

DEVNET-2003


Numeric int / float / complex Types that describe numeric content

Boolean bool Types that define true/false relationships Logical operators: and / or / not

Text str Immutable string objects 1,2, or 3 quotes

Sequence Lists

Typically homogeneous sequences of objects An mutable, ordered array Square Brackets

Tuple Typically heterogeneous sequences of objects An immutable collection Parenthesis

Mapping Dictionaries

A mutable, unordered, associative array Curly Brackets

Python Data Types

22DEVNET-2003


Python Data Types

23

Type Example• Numeric: Integer, Float x = 10 x = 1.0

• String x= ‘Mike’

• Boolean y = True x = False

• List my_list = [10, 20, 30]• Tuple my_tuple = (‘Brett’, ‘Cisco',

‘Cary’,2015)• Dictionary my_dict = {"one":1, "two":2}• Lists in Lists my_list2=[[10,20,30], [‘Cisco

Live’, ‘May’, 2016]]

DEVNET-2003


Demo


Labs 1 & 2

DEVNET-2003 25


• Add to your python script myworld.py

• Add a list with two elements

• Add a tuple with three elements

• Add a dictionary with two name value pairs

• Print one value from each data type you created

Lab -2 : 10 minutes

26

Lab -1 : 5 minutes• Code and Run:Python Hello

World • Name file: myworld.py• Prints Hello World!• Assigns a variable• Checks the value “Remember

if (value == value):”• Prints statement within if

statement. Must be indented!

DEVNET-2003


Coding-102-REST-python-ga Examples• create-ticket.py

• simple example to create ticket for authentication

• get-network-hosts.py • returns links of hosts

• get-network-devices.py• returns list of network devices

• build-topology.py• Reads and displays topology in spreadsheet format.

DEVNET-2003


First REST call from Pythonimport requestsimport json

url = 'https://sandboxapic.cisco.com/api/v1/ticket’payload = {"username":“devnetuser","password":"Cisco123!"}header = {"content-type": "application/json”}response= requests.post(url,data=json.dumps(payload), headers=header, verify=False)

print(response.text)

Source code file: create-ticket.py

DEVNET-2003 28


Demo


Lab-3


Lab 3 – 10 Minutes

Go to directory: coding102-REST-python-ga get-network-hosts.py

Edit file to store values below in variable(s) and print to screen: hostIP, hostMac, hostType

DEVNET-2003 31


Final Thoughts

32DEVNET-2003


DevNet GitHub

coding-skills-sample-code repository• All the code for this session • All the code for all of the Coding Skills Learning Labs


DEVNET-2003 33


• Learning Labs• http://learninglabs.cisco.com

• Network Programmability Springboard• https://learninglabs.cisco.com/springboards

• Devnet• http://developer.cisco.com

• The DevNet Zone Learning Labs• Come see us!

Where to go From Here

34DEVNET-2003

http://learninglabs.cisco.com/

https://learninglabs.cisco.com/springboards

https://learninglabs.cisco.com/springboards

http://developer.cisco.com/



Complete Your Online Session Evaluation

Don’t forget: Cisco Live sessions will be available for viewing on-demand after the event at CiscoLive.com/Online

• Give us your feedback to be entered into a Daily Survey Drawing. A daily winner will receive a $750 Amazon gift card.

• Complete your session surveys through the Cisco Live mobile app or from the Session Catalog on CiscoLive.com/us.

35DEVNET-2003

http://ciscolive.com/Online

http://ciscolive.com/us


Continue Your Education• Demos in the Cisco campus

• Walk-in Self-Paced Labs

• Lunch & Learn

• Meet the Engineer 1:1 meetings

• Related sessions


Please join us for the Service Provider Innovation Talk featuring:

Yvette Kanouff | Senior Vice President and General Manager, SP BusinessJoe Cozzolino | Senior Vice President, Cisco Services

Thursday, July 14th, 201611:30 am - 12:30 pm, In the Oceanside A room

What to expect from this innovation talk• Insights on market trends and forecasts• Preview of key technologies and capabilities • Innovative demonstrations of the latest and greatest products• Better understanding of how Cisco can help you succeed

Register to attend the session live now or watch the broadcast on cisco.com

DEVNET-2003 37


DevNet APIC-EM Always On Sandbox

Always there for you to use…

•Register on Cisco DevNet (http://developer.cisco.com ) to get the latest information about APIs as they are release•You can use the Always-On APIC-EM GA Sandbox at anytime•You can use https://learninglabs.cisco.com at anytime•APIC-EM Login: username: admin password: C!sc0123

https://sandboxapic.cisco.com:9443

DEVNET-2003


https://learninglabs.cisco.com/


DevNet GitHub

coding-skills-sample-code repository• All the code for this session • All the code for all of the Coding Skills Learning Labs


DEVNET-2003

Coding 102: REST API Basics using APIC-EM

Technology

Transcript of Coding 102: REST API Basics using APIC-EM