[![](https://img.shields.io/pypi/v/ucsmsdk.svg)](https://pypi.python.org/pypi/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.21 (2024-11-05)
---------------------
* Support for UCSM release 4.3(5a)
0.9.20 (2024-09-20)
---------------------
* Fixes for encoding failure during firmware upload
0.9.19 (2024-08-28)
---------------------
* Support for UCSM release 4.3(4b)
0.9.18 (2024-06-13)
---------------------
* Support for UCSM release 4.3(4a)
0.9.17 (2024-04-19)
---------------------
* Support for UCSM release 4.3(3a)
0.9.16 (2023-10-12)
---------------------
* Fixes the issue where acknowledging a fault was not working via ucsmsdk
0.9.15 (2023-08-29)
---------------------
* Support for UCSM release 4.3(2b)
0.9.14 (2023-01-13)
---------------------
* Support for UCSM release 4.2(3b)
0.9.13 (2022-07-21)
---------------------
* Support for UCSM release 4.2(2a)
0.9.12 (2021-08-30)
---------------------
* Fixes for python 3.9 compatibility
* Fixes issue in earlier release
0.9.11 (2021-08-25)
---------------------
* Support for UCSM release 4.2(1a)
0.9.10 (2020-04-23)
---------------------
* Support for UCSM release 4.1(1a), 4.1(1b), 4.1(1c)
0.9.9 (2019-12-20)
---------------------
* Support for UCSM release 4.0(4a)
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
Raw data
{
"_id": null,
"home_page": "https://github.com/CiscoUcs/ucsmsdk",
"name": "ucsmsdk",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "ucsmsdk",
"author": "Cisco Systems Inc",
"author_email": "ucs-python@cisco.com",
"download_url": "https://files.pythonhosted.org/packages/09/40/e0b836b78f5ad14cb1064b103ee6fc2a1c6bc1ead9ae31a1bb4fc3dd6484/ucsmsdk-0.9.21.tar.gz",
"platform": null,
"description": "[![](https://img.shields.io/pypi/v/ucsmsdk.svg)](https://pypi.python.org/pypi/ucsmsdk)\n[![Documentation Status](https://readthedocs.org/projects/ucsmsdk/badge/?version=latest)](http://ucsmsdk.readthedocs.io/en/latest/?badge=latest)\n\n# Python SDK for Cisco UCS\n\n* Apache License, Version 2.0 (the \"License\")\n* Documentation: http://ucsmsdk.readthedocs.io/\n\n## Installation\n\nThe SDK can be installed using any of ways below,\n\n### From pip:\n\nInstalls the last released version,\n\n```\n pip install ucsmsdk\n```\n\n### From github:\n\nInstalls the latest top of the tree development version,\n\n```\n # Install pip (skip if pip is already available):\n wget https://bootstrap.pypa.io/get-pip.py\n python get-pip.py\n\n git clone https://github.com/CiscoUcs/ucsmsdk.git\n cd ucsmsdk\n make install\n```\n\n## Documentation\n\n* https://github.com/ciscoucs/ucsm_apis provides APIs for many Ucs operations.\n* We encourage contributions to the ucsm_apis repository\n\n\n## Community:\n\n* We are on Slack - slack requires registration, but the ucspython team is open invitation to\n anyone to register [here](https://ucspython.herokuapp.com)\n\n\n\n\nHistory\n-------\n\n0.9.21 (2024-11-05)\n---------------------\n* Support for UCSM release 4.3(5a)\n\n0.9.20 (2024-09-20)\n---------------------\n* Fixes for encoding failure during firmware upload \n\n0.9.19 (2024-08-28)\n---------------------\n* Support for UCSM release 4.3(4b)\n\n0.9.18 (2024-06-13)\n---------------------\n* Support for UCSM release 4.3(4a)\n\n0.9.17 (2024-04-19)\n---------------------\n* Support for UCSM release 4.3(3a)\n\n0.9.16 (2023-10-12)\n---------------------\n* Fixes the issue where acknowledging a fault was not working via ucsmsdk\n\n0.9.15 (2023-08-29)\n---------------------\n* Support for UCSM release 4.3(2b)\n\n0.9.14 (2023-01-13)\n---------------------\n* Support for UCSM release 4.2(3b)\n\n0.9.13 (2022-07-21)\n---------------------\n* Support for UCSM release 4.2(2a)\n\n0.9.12 (2021-08-30)\n---------------------\n* Fixes for python 3.9 compatibility\n* Fixes issue in earlier release\n\n0.9.11 (2021-08-25)\n---------------------\n* Support for UCSM release 4.2(1a)\n\n\n0.9.10 (2020-04-23)\n---------------------\n* Support for UCSM release 4.1(1a), 4.1(1b), 4.1(1c)\n\n0.9.9 (2019-12-20)\n---------------------\n* Support for UCSM release 4.0(4a)\n\n\n0.9.8 (2019-01-22)\n---------------------\n* Support for UCSM release 4.0(2a)\n\n\n0.9.6 (2018-12-11)\n---------------------\n* Support for UCSM release 4.0(1b)\n\n\n0.9.5 (2018-10-10)\n---------------------\n* Updated requirements to include setuptools\n\n\n0.9.4 (2018-08-13)\n---------------------\n* Fixes for python 3 compatibility\n\n\n0.9.3.2 (2018-04-25)\n---------------------\n* Support for UCSM release 3.2(3a)\n* Support for accepting array arguments in query_classids, query_dns\n* Support for setting response timeout for the UCSM operations (query/config)\n* Handling `auto_refresh` flag in unfreeze\n* Fixing issue with None value check of property by removing None check from validation of property/check_prop_match\n* Fixing issue where error happens with commit when threading is enabled and commit buffer is empty\n* Fixing issue where ssl with \"Only TLS 1.2\" does not work\n\n0.9.3.1 (2017-01-25)\n---------------------\n\n* Removed `jsonpickle` dependency\n\n0.9.3.0 (2017-01-25)\n---------------------\n\n* Support for estimating impact of a transaction - `handle.estimate_impact`\n* Support for TLS 1.1, 1.2 Newer UCSM releases support TLS1.2. HTTPS connection\n to the servers with newer releases might fail in absence of TLS1.1/1.2\n support.\n* Added command line script to make running `convert_to_ucs_python` easier.\n bin/watch_ucs.py in the github repo.\n* Special characters like <,>,& in XML values are deemed invalid and cause\n failure in parsing XML. Added a recovery logic if these exist in the XML\n value fields.\n* Support for serialization, deserialization of UcsHandle\n* Support for UCSM inventory via `get_inventory` API\n\n0.9.2.0 (2016-09-21)\n---------------------\n\n* Support for UCSM 3.1(2b)\n* Adds Support for Generating python APIs from a Ucs backup xml -\n `convert_from_backup`\n* Adds Infra to facilitate and notify users of API deprecation\n* Allows the ucsmsdk/apis layer APIs to pass in None values to indicate that no\n change is rquested to those specific params\n* Adds a method to check if the handle.cookie is still valid\n* Fix in eventhandlers, where some events were not getting processed\n* Fix in eventhandlers, where timeout was not getting triggered until new\n events\n* Fix in get_ucs_tech_support, where techsupport for rack server was failing\n* Fix in logout, where a Ctrl+C was causing stale connections on the server\n* Deprecated `get_ucs_tech_support` in favour of `get_tech_support`. The newer\n API simplifies the API\n\n0.9.1.1 (2016-07-12)\n---------------------\n\n* Support for UCSM 2.2.7\n* Simplified event handlers to a single `wait_for_event` method. `UcsEventHandler` internals are hidden from user.\n* Support for showing progress for upload/download operations\n* Support for multi-threading in SDK. An application can run multiple threads that can use SDK methods in parallel.\n* Support for multiple parallel transactions via the `tag` parameter in `add_mo`, `set_mo`, `remove_mo`, `commit_mo`\n* Fix for `convert_to_ucs_python` exception in some scenarios\n* Fix for `convert_to_ucs_python` not displaying python script for Java6u45\n* Fix for event handlers not trigerring for some events\n* Added more unit and system tests\n* Better Documentation\n\n0.9.1.0 (2016-05-25)\n---------------------\n\n* Support for UCSM 3.1.1\n* Support for Python 3.x\n* Support for Comparing and Syncing Objects across Ucs Domains - `compare_ucs_mo` `sync_ucs_mo`\n* Support for `filter_str` in `query_children` method\n* Support to drill down into Managed Object Meta and Property Meta details - `get_meta_info`\n* Support to monitor **any/all** change(s) in a ManagedObject with `UcsEventHandler`\n* Fix for Unable to make unsecured connection when redirection was enabled on the server\n* Fix for issues with the usage of force parameter in `Login` method\n* Fix for `not` filter not generating filter request\n* Fix for TechSupport not getting removed from server even when `remove_from_ucs=True`\n* Fix for convert_to_ucs_python not redirecting output to a file\n* Fix for convert_to_ucs_python not working correctly when `gui_log=True`\n* More PEP8 compliance related fixes\n\n0.9.0.0 (2015-01-11)\n---------------------\n\n* Python SDK for UCS server management and related automation\n* Supports every Managed Object exposed by Ucs\n* APIs for CRUD operations simplified\n* Support for server side filters made simpler\n* Support for eventhandlers\n* Runtime memory usage is reduced\n* Nosetests for unit testing\n* Samples directory for more real world use cases\n* Integrating the sphinx framework for documentation\n* PEP8 Compliance\n",
"bugtrack_url": null,
"license": "http://www.apache.org/licenses/LICENSE-2.0",
"summary": "Python SDK for Cisco UCS",
"version": "0.9.21",
"project_urls": {
"Homepage": "https://github.com/CiscoUcs/ucsmsdk"
},
"split_keywords": [
"ucsmsdk"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0c04b982e2145682458ce941b2b459623388d85af2951c83283cbc6334cefb25",
"md5": "38385efdba6aced0fd1f10eeb90a2765",
"sha256": "4897fd5c6a53cbe8ccbe8e3e5d52ef268a1c7627296ff5db5a548950486ef7bd"
},
"downloads": -1,
"filename": "ucsmsdk-0.9.21-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "38385efdba6aced0fd1f10eeb90a2765",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 6817438,
"upload_time": "2024-11-07T06:19:55",
"upload_time_iso_8601": "2024-11-07T06:19:55.942391Z",
"url": "https://files.pythonhosted.org/packages/0c/04/b982e2145682458ce941b2b459623388d85af2951c83283cbc6334cefb25/ucsmsdk-0.9.21-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0940e0b836b78f5ad14cb1064b103ee6fc2a1c6bc1ead9ae31a1bb4fc3dd6484",
"md5": "2c2bdc41314aeb1faa4b181c3b28baeb",
"sha256": "fd86242bc0cfee72303e338cb98d1f171ad92243af0f3cf6a4fdba74bbbd3f62"
},
"downloads": -1,
"filename": "ucsmsdk-0.9.21.tar.gz",
"has_sig": false,
"md5_digest": "2c2bdc41314aeb1faa4b181c3b28baeb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4599375,
"upload_time": "2024-11-07T06:19:57",
"upload_time_iso_8601": "2024-11-07T06:19:57.563092Z",
"url": "https://files.pythonhosted.org/packages/09/40/e0b836b78f5ad14cb1064b103ee6fc2a1c6bc1ead9ae31a1bb4fc3dd6484/ucsmsdk-0.9.21.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-07 06:19:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CiscoUcs",
"github_project": "ucsmsdk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"landscape": true,
"requirements": [
{
"name": "setuptools",
"specs": []
},
{
"name": "pyparsing",
"specs": []
},
{
"name": "six",
"specs": []
}
],
"tox": true,
"lcname": "ucsmsdk"
}