CiscoDevNet/python_code_samples_networkPublic

NotificationsYou must be signed in to change notification settings
Fork465
Star714

A collection of Python Code Samples for Network Management. Includes samples to run on-box and off-box.

License

MIT license

714 stars 465 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 121 Commits
EEM-interface-move-routes		EEM-interface-move-routes
NC-edit-config		NC-edit-config
NC-get-config-xpath		NC-get-config-xpath
NC-get-config		NC-get-config
PortFlap_email_alert		PortFlap_email_alert
Py-sho-ver-onbox		Py-sho-ver-onbox
RC-get-config		RC-get-config
RC-get-serial-numbers		RC-get-serial-numbers
RESTCONF		RESTCONF
acitoolkit_show_tenants		acitoolkit_show_tenants
apic-em_get_hosts		apic-em_get_hosts
apic-em_get_inventory_stats		apic-em_get_inventory_stats
eem_configdiff_to_spark		eem_configdiff_to_spark
model-based-aaa		model-based-aaa
netconf_entity		netconf_entity
netmiko-interface-example		netmiko-interface-example
restconf_update_ipaddress		restconf_update_ipaddress
snmp_entity		snmp_entity
spark_checkin		spark_checkin
tdr-test		tdr-test
.gitignore		.gitignore
AGENTS.md		AGENTS.md
LICENSE		LICENSE
README.md		README.md

Repository files navigation

Network Automation with Python Code Samples

A collection of Python Code Samples for Network Management. Includes samples that leverage on-box libraries, as well as samples that use exposed external APIs (NETCONF/RESTCONF, SNMP, SSH, REST, etc). Some examples make use of available SDKs.

On-Box Examples

Many Cisco switches and routers provide an on-box Python Interpreter that can be leveraged to execute scripts and programs directly on end devices. In addition to the interpreter, Python libraries are included that provide direct access to the underlying devices operations to execute CLI commands, or monitor for events.

Sample Code

Code Sample	Description
Execute CLI via Python	This example is about as simple as it gets. By leveraging the CLI library, we execute the “show version” command on the box.
TDR Test Every Interface	This example once again leverages the CLI library, but to do something a bit more interesting. A TDR test is run on every interface in “up” status.
EEM Config Changes to Spark	In this example, the EEM library is used to monitor for configuration changes. When one occurs a message is sent to a Cisco Spark Room.
Python with Eventing Example	Use the EEM and Python together to script based on local events.
EEM + Python + Spark ChatOps	Use the EEM to monitor for config changes and send a Spark Message
EEM + Python + Email alert	This example leverages the CLI library and using the EEM feature to monitor for interface flapping and send an email alert

Off-Box Examples

Here are few Python scripts that can interact with network elements using one of the many exposed interfaces (NETCONF, RESTCONF, SNMP, SSH, etc). Many of these scripts could also be run on-box, however they don’t leverage any of the unique libraries available on device.

Code Sample	Description
Netmiko and CLI Example for Interface Management	These are a series of python scripts for retrieving, creating, deleting a Loopback Interface with Python.
MIB Walk with Python	In this example, we perform a MIB walk against a device leveraging the “netsnmp” library for Python.
NETCONF Connection with Python	This example shows the basics of connecting to a device with NETCONF using the “ncclient” library for Python.
Configure Interface IP Address with RESTCONF	In this example the newly ratified RESTCONF standard is used to configure the IP Address on an interface.
Get Inventory from APIC-EM	APIC-EM maintains an inventory database of the entire network. In this example Python is used to retrieve that information using the REST API.
Get Host List from APIC-EM	APIC-EM maintains a list of all clients connected to the network devices discovered by APIC-EM. This example queries the APIC-EM for the list, and display’s it in a simple table.
Retrieve Tenants from ACI APIC	This example leverages the ACI Toolkit to connect to an APIC controller and retrieve the list of Tenants configured.
Basic NETCONF Get	A basic ncclient example to`<get>` NETCONF Data
Basic NETCONF Edit	A basic ncclient example to`<edit-config>` NETCONF Data
NETCONF XPATH Example	Use the XPATH feature when making a NETCONF Requests
Model Based AAA	These example scripts are for Model Based AAA to get, edit and delete the rule-lists for privilege level users and Groups by using ietf-netconf-acm.yang data model
RESTCONF	These example scripts are for RESTCONF to retrieve and configure the switch using different operations such as Get, Delete, Put, Post and Patch.