vmware / pyvmomi

VMware vSphere API Python Bindings
Apache License 2.0
2.19k stars 766 forks source link

pyvmomi

.. |downloads| image:: https://img.shields.io/pypi/dm/pyvmomi.svg :target: https://pypi.python.org/pypi/pyvmomi/ .. |py-version| image:: https://img.shields.io/pypi/pyversions/pyVmomi

|downloads| |py-version|

pyVmomi is the Python SDK for the VMware vSphere Management API that allows you to rapidly build solutions integrated with VMware ESXi and vCenter Server. For accessing features from the vSphere Automation APIs <https://developer.vmware.com/apis/vsphere-automation/latest/> (REST), please refer to the VMware vSphere Automation SDK for Python <https://github.com/vmware/vsphere-automation-sdk-python/>.

.. contents:: Table of Contents :depth: 1 :local: :backlinks: none

Getting Started

To get started, see the getting started guide <http://vmware.github.io/pyvmomi-community-samples/#getting-started>. You'll need Python <https://www.python.org/downloads/>, pip <https://pip.pypa.io/en/latest/installation/>, and the samples project <http://vmware.github.io/pyvmomi-community-samples/>.

Installing

The master is code that is in development, official releases are tagged and posted to pypi <https://pypi.python.org/pypi/pyvmomi/>_

Testing

Unit tests can be invoked by using the tox <https://testrun.org/tox/>_ command. You may have to configure multiple python interpreters so that you can test in all the environments listed in tox.ini or you will have to run tox with the -e flag to run only in your version of python. For example, if you only have Python 2.7 then tox -e py27 will limit your test run to Python 2.7.

Contributing

Documentation

For general language neutral documentation of vSphere Management API see:

Python Support

Versioning

pyVmomi: X.Y.Z.U.P

vCenter-related: X.Y - (Major release), Z - (Update release), U - (Patch)

pyVmomi-related: P - (pyVmomi patches)

Compatibility Policy

pyVmomi maintains minimum backward compatibility with the previous four releases of vSphere and it's own previous four releases. Compatibility with much older versions may continue to work but will not be actively supported.

For example, version v6.0.0 is most compatible with vSphere 6.0, 5.5, 5.1 and 5.0. Initial releases compatible with a version of vSphere will bare a naked version number of v6.0.0 indicating that version of pyVmomi was released simultaneously with the GA version of vSphere with the same version number.

Support

For official support, users with 'Active - Premium SDK Support, Standard SDK Support, Premier/Success 360, and VMware Select Support <https://www.vmware.com/content/dam/digitalmarketing/vmware/en/pdf/docs/vmware-select-support-specific-program-document.pdf>_ can reach out to VMware Global Support <https://kb.vmware.com/s/article/87265?lang=en_US> for any issues in line with our SDK and API Support policy <https://www.vmware.com/support/services/sdk.html>. For community support, please open a Github issue <https://github.com/vmware/pyvmomi/issues> or start a Discussion <https://github.com/vmware/pyvmomi/discussions>.

Related Projects

Have fun!