Community-developed Python SDK for the DNA Center APIs
Project description
Work with the DNA Center APIs in native Python!
dnacentersdk is a community developed Python library for working with the DNA Center APIs. Our goal is to make working with DNA Center in Python a native and natural experience!
from dnacentersdk import api
dnac = api.DNACenterAPI(username="devnetuser", password="Cisco123!")
# Find all devices that have 'Switches and Hubs' in their family
devices = dnac.devices.get_device_list(family='Switches and Hubs')
# Print all of demo devices
for device in devices.response:
print('{:20s}{}'.format(device.hostname, device.upTime))
# Find all tags
all_tags = dnac.tag.get_tag(sort_by='name', order='des')
demo_tags = [tag for tag in all_tags.response if 'Demo' in tag.name ]
# Delete all of the demo tags
for tag in demo_tags:
dnac.tag.delete_tag(tag.id)
# Create a new demo tag
demo_tag = dnac.tag.create_tag(name='dna Demo')
task_demo_tag = dnac.task.get_task_by_id(task_id=demo_tag.response.taskId)
if not task_demo_tag.response.isError:
# Retrieve created tag
created_tag = dnac.tag.get_tag(name='dna Demo')
# Update tag
update_tag = dnac.tag.update_tag(id=created_tag.response[0].id,
name='Updated ' + created_tag.response[0].name,
description='DNA demo tag')
print(dnac.task.get_task_by_id(task_id=update_tag.response.taskId).response.progress)
# Retrieved updated
updated_tag = dnac.tag.get_tag(name='Updated dna Demo')
print(updated_tag)
else:
# Get task error details
print('Unfortunately ', task_demo_tag.response.progress)
print('Reason: ', task_demo_tag.response.failureReason)
That’s more than 10 DNA Center API calls in less than 41 lines of code (with comments, whitespaces and print statemets).
dnacentersdk makes your life better… Learn how!
Installation
Installing and upgrading dnacentersdk is easy:
Install via PIP
$ pip install dnacentersdk
Upgrading to the latest Version
$ pip install dnacentersdk --upgrade
Documentation
Excellent documentation is now available at: http://dnacentersdk.readthedocs.io
Check out the Quickstart to dive in and begin using dnacentersdk.
Release Notes
Please see the releases page for release notes on the incremental functionality and bug fixes incorporated into the published releases.
Questions, Support & Discussion
dnacentersdk is a community developed and community supported project. If you experience any issues using this package, please report them using the issues page.
Please join the Python DNA Center Devs DNA Center space to ask questions, join the discussion, and share your projects and creations.
Contribution
dnacentersdk is a community development projects. Feedback, thoughts, ideas, and code contributions are welcome! Please see the Contributing guide for more information.
Copyright (c) 2019 Cisco and/or its affiliates.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dnacentersdk-1.2.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5671f039769ff34387add3d0346ecd5fa1870b73857322734e7126cccc77dcbb |
|
MD5 | ab5632ec0d9554d18a732e0d86377041 |
|
BLAKE2b-256 | 81d06e4ab82f47c769d1f8022898cb7f41d06192dda22d8d5ee18e17ae53545d |