Python SDK for Cisco UCS
Project description
[![](https://img.shields.io/travis/CiscoUcs/ucsmsdk.svg)](https://travis-ci.org/CiscoUcs/ucsmsdk)
[![](https://ucspython.herokuapp.com/badge.svg)](https://ucspython.herokuapp.com)
[![](https://img.shields.io/pypi/v/ucsmsdk.svg)](https://pypi.python.org/pypi/ucsmsdk)
[![Code Climate](https://codeclimate.com/github/CiscoUcs/ucsmsdk/badges/gpa.svg)](https://codeclimate.com/github/CiscoUcs/ucsmsdk)
[![Documentation Status](https://readthedocs.org/projects/ucsmsdk/badge/?version=latest)](http://ucsmsdk.readthedocs.io/en/latest/?badge=latest)
# Python SDK for Cisco UCS
* Apache License, Version 2.0 (the "License")
* Documentation: http://ucsmsdk.readthedocs.io/
## Installation
The SDK can be installed using any of ways below,
### From pip:
Installs the last released version,
```
pip install ucsmsdk
```
### From github:
Installs the latest top of the tree development version,
```
# Install pip (skip if pip is already available):
wget https://bootstrap.pypa.io/get-pip.py
python get-pip.py
git clone https://github.com/CiscoUcs/ucsmsdk.git
cd ucsmsdk
make install
```
## Documentation
* https://github.com/ciscoucs/ucsm_apis provides APIs for many Ucs operations.
* We encourage contributions to the ucsm_apis repository
## Community:
* We are on Slack - slack requires registration, but the ucspython team is open invitation to
anyone to register [here](https://ucspython.herokuapp.com)
History
-------
0.9.8 (2019-01-22)
---------------------
* Support for UCSM release 4.0(2a)
0.9.6 (2018-12-11)
---------------------
* Support for UCSM release 4.0(1b)
0.9.5 (2018-10-10)
---------------------
* Updated requirements to include setuptools
0.9.4 (2018-08-13)
---------------------
* Fixes for python 3 compatibility
0.9.3.2 (2018-04-25)
---------------------
* Support for UCSM release 3.2(3a)
* Support for accepting array arguments in query_classids, query_dns
* Support for setting response timeout for the UCSM operations (query/config)
* Handling `auto_refresh` flag in unfreeze
* Fixing issue with None value check of property by removing None check from validation of property/check_prop_match
* Fixing issue where error happens with commit when threading is enabled and commit buffer is empty
* Fixing issue where ssl with "Only TLS 1.2" does not work
0.9.3.1 (2017-01-25)
---------------------
* Removed `jsonpickle` dependency
0.9.3.0 (2017-01-25)
---------------------
* Support for estimating impact of a transaction - `handle.estimate_impact`
* Support for TLS 1.1, 1.2 Newer UCSM releases support TLS1.2. HTTPS connection
to the servers with newer releases might fail in absence of TLS1.1/1.2
support.
* Added command line script to make running `convert_to_ucs_python` easier.
bin/watch_ucs.py in the github repo.
* Special characters like <,>,& in XML values are deemed invalid and cause
failure in parsing XML. Added a recovery logic if these exist in the XML
value fields.
* Support for serialization, deserialization of UcsHandle
* Support for UCSM inventory via `get_inventory` API
0.9.2.0 (2016-09-21)
---------------------
* Support for UCSM 3.1(2b)
* Adds Support for Generating python APIs from a Ucs backup xml -
`convert_from_backup`
* Adds Infra to facilitate and notify users of API deprecation
* Allows the ucsmsdk/apis layer APIs to pass in None values to indicate that no
change is rquested to those specific params
* Adds a method to check if the handle.cookie is still valid
* Fix in eventhandlers, where some events were not getting processed
* Fix in eventhandlers, where timeout was not getting triggered until new
events
* Fix in get_ucs_tech_support, where techsupport for rack server was failing
* Fix in logout, where a Ctrl+C was causing stale connections on the server
* Deprecated `get_ucs_tech_support` in favour of `get_tech_support`. The newer
API simplifies the API
0.9.1.1 (2016-07-12)
---------------------
* Support for UCSM 2.2.7
* Simplified event handlers to a single `wait_for_event` method. `UcsEventHandler` internals are hidden from user.
* Support for showing progress for upload/download operations
* Support for multi-threading in SDK. An application can run multiple threads that can use SDK methods in parallel.
* Support for multiple parallel transactions via the `tag` parameter in `add_mo`, `set_mo`, `remove_mo`, `commit_mo`
* Fix for `convert_to_ucs_python` exception in some scenarios
* Fix for `convert_to_ucs_python` not displaying python script for Java6u45
* Fix for event handlers not trigerring for some events
* Added more unit and system tests
* Better Documentation
0.9.1.0 (2016-05-25)
---------------------
* Support for UCSM 3.1.1
* Support for Python 3.x
* Support for Comparing and Syncing Objects across Ucs Domains - `compare_ucs_mo` `sync_ucs_mo`
* Support for `filter_str` in `query_children` method
* Support to drill down into Managed Object Meta and Property Meta details - `get_meta_info`
* Support to monitor **any/all** change(s) in a ManagedObject with `UcsEventHandler`
* Fix for Unable to make unsecured connection when redirection was enabled on the server
* Fix for issues with the usage of force parameter in `Login` method
* Fix for `not` filter not generating filter request
* Fix for TechSupport not getting removed from server even when `remove_from_ucs=True`
* Fix for convert_to_ucs_python not redirecting output to a file
* Fix for convert_to_ucs_python not working correctly when `gui_log=True`
* More PEP8 compliance related fixes
0.9.0.0 (2015-01-11)
---------------------
* Python SDK for UCS server management and related automation
* Supports every Managed Object exposed by Ucs
* APIs for CRUD operations simplified
* Support for server side filters made simpler
* Support for eventhandlers
* Runtime memory usage is reduced
* Nosetests for unit testing
* Samples directory for more real world use cases
* Integrating the sphinx framework for documentation
* PEP8 Compliance
[![](https://ucspython.herokuapp.com/badge.svg)](https://ucspython.herokuapp.com)
[![](https://img.shields.io/pypi/v/ucsmsdk.svg)](https://pypi.python.org/pypi/ucsmsdk)
[![Code Climate](https://codeclimate.com/github/CiscoUcs/ucsmsdk/badges/gpa.svg)](https://codeclimate.com/github/CiscoUcs/ucsmsdk)
[![Documentation Status](https://readthedocs.org/projects/ucsmsdk/badge/?version=latest)](http://ucsmsdk.readthedocs.io/en/latest/?badge=latest)
# Python SDK for Cisco UCS
* Apache License, Version 2.0 (the "License")
* Documentation: http://ucsmsdk.readthedocs.io/
## Installation
The SDK can be installed using any of ways below,
### From pip:
Installs the last released version,
```
pip install ucsmsdk
```
### From github:
Installs the latest top of the tree development version,
```
# Install pip (skip if pip is already available):
wget https://bootstrap.pypa.io/get-pip.py
python get-pip.py
git clone https://github.com/CiscoUcs/ucsmsdk.git
cd ucsmsdk
make install
```
## Documentation
* https://github.com/ciscoucs/ucsm_apis provides APIs for many Ucs operations.
* We encourage contributions to the ucsm_apis repository
## Community:
* We are on Slack - slack requires registration, but the ucspython team is open invitation to
anyone to register [here](https://ucspython.herokuapp.com)
History
-------
0.9.8 (2019-01-22)
---------------------
* Support for UCSM release 4.0(2a)
0.9.6 (2018-12-11)
---------------------
* Support for UCSM release 4.0(1b)
0.9.5 (2018-10-10)
---------------------
* Updated requirements to include setuptools
0.9.4 (2018-08-13)
---------------------
* Fixes for python 3 compatibility
0.9.3.2 (2018-04-25)
---------------------
* Support for UCSM release 3.2(3a)
* Support for accepting array arguments in query_classids, query_dns
* Support for setting response timeout for the UCSM operations (query/config)
* Handling `auto_refresh` flag in unfreeze
* Fixing issue with None value check of property by removing None check from validation of property/check_prop_match
* Fixing issue where error happens with commit when threading is enabled and commit buffer is empty
* Fixing issue where ssl with "Only TLS 1.2" does not work
0.9.3.1 (2017-01-25)
---------------------
* Removed `jsonpickle` dependency
0.9.3.0 (2017-01-25)
---------------------
* Support for estimating impact of a transaction - `handle.estimate_impact`
* Support for TLS 1.1, 1.2 Newer UCSM releases support TLS1.2. HTTPS connection
to the servers with newer releases might fail in absence of TLS1.1/1.2
support.
* Added command line script to make running `convert_to_ucs_python` easier.
bin/watch_ucs.py in the github repo.
* Special characters like <,>,& in XML values are deemed invalid and cause
failure in parsing XML. Added a recovery logic if these exist in the XML
value fields.
* Support for serialization, deserialization of UcsHandle
* Support for UCSM inventory via `get_inventory` API
0.9.2.0 (2016-09-21)
---------------------
* Support for UCSM 3.1(2b)
* Adds Support for Generating python APIs from a Ucs backup xml -
`convert_from_backup`
* Adds Infra to facilitate and notify users of API deprecation
* Allows the ucsmsdk/apis layer APIs to pass in None values to indicate that no
change is rquested to those specific params
* Adds a method to check if the handle.cookie is still valid
* Fix in eventhandlers, where some events were not getting processed
* Fix in eventhandlers, where timeout was not getting triggered until new
events
* Fix in get_ucs_tech_support, where techsupport for rack server was failing
* Fix in logout, where a Ctrl+C was causing stale connections on the server
* Deprecated `get_ucs_tech_support` in favour of `get_tech_support`. The newer
API simplifies the API
0.9.1.1 (2016-07-12)
---------------------
* Support for UCSM 2.2.7
* Simplified event handlers to a single `wait_for_event` method. `UcsEventHandler` internals are hidden from user.
* Support for showing progress for upload/download operations
* Support for multi-threading in SDK. An application can run multiple threads that can use SDK methods in parallel.
* Support for multiple parallel transactions via the `tag` parameter in `add_mo`, `set_mo`, `remove_mo`, `commit_mo`
* Fix for `convert_to_ucs_python` exception in some scenarios
* Fix for `convert_to_ucs_python` not displaying python script for Java6u45
* Fix for event handlers not trigerring for some events
* Added more unit and system tests
* Better Documentation
0.9.1.0 (2016-05-25)
---------------------
* Support for UCSM 3.1.1
* Support for Python 3.x
* Support for Comparing and Syncing Objects across Ucs Domains - `compare_ucs_mo` `sync_ucs_mo`
* Support for `filter_str` in `query_children` method
* Support to drill down into Managed Object Meta and Property Meta details - `get_meta_info`
* Support to monitor **any/all** change(s) in a ManagedObject with `UcsEventHandler`
* Fix for Unable to make unsecured connection when redirection was enabled on the server
* Fix for issues with the usage of force parameter in `Login` method
* Fix for `not` filter not generating filter request
* Fix for TechSupport not getting removed from server even when `remove_from_ucs=True`
* Fix for convert_to_ucs_python not redirecting output to a file
* Fix for convert_to_ucs_python not working correctly when `gui_log=True`
* More PEP8 compliance related fixes
0.9.0.0 (2015-01-11)
---------------------
* Python SDK for UCS server management and related automation
* Supports every Managed Object exposed by Ucs
* APIs for CRUD operations simplified
* Support for server side filters made simpler
* Support for eventhandlers
* Runtime memory usage is reduced
* Nosetests for unit testing
* Samples directory for more real world use cases
* Integrating the sphinx framework for documentation
* PEP8 Compliance
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
ucsmsdk-0.9.8.tar.gz
(4.2 MB
view hashes)
Built Distribution
Close
Hashes for ucsmsdk-0.9.8-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 305b1a07fca6d09530acc2c29aa79dbfa5b41b01110ea1e8ef346bcbb17460da |
|
MD5 | dfd130abb5739d808a0ab4a610aed261 |
|
BLAKE2b-256 | 7300a9985b8e9353d043e28a98686a1d7017d7f450e9633f9ba573a608271e04 |