Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A command line client for the VMWare vCloud director API
Python
tree: 548e81ce4b

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
test
vcloudtools
.gitignore
.travis.yml
LICENSE
README.rst
setup.py
tox.ini

README.rst

vcloudtools

A set of commandline utilities to aid working with the VMWare vCloud API.

At the moment, vcloudtools is pretty minimal, but there's still enough here to be useful. In addition to a Python API client (vcloudtools.api.VCloudAPIClient), there's a series of small command line utilities to help interact with vCloud Director's HTTP API.

Installation

vcloudtools is available on the Python Package Index:

$ pip install vcloudtools

Usage

Simple usage. First, tell vcloudtools where your vCloud Director API is by adding an environment variable to your .bash_profile or similar:

$ echo "export VCLOUD_API_ROOT=https://vcd.example.com/api" >> ~/.bash_profile
$ exec $SHELL

Then, login to the VCD API:

$ eval `vcloud-login`

You can now use vcloudtools without further authentication hassles. So far, the available tools include vcloud-org:

$ vcloud-org list
$ vcloud-org show My-Org-Name

vcloud-org will emit JSON, which you can parse with jsontool or similar.

You can also manually browse the API with vcloud-browse:

$ vcloud-browse /session
$ vcloud-browse /org/7318a9a7-cc79-4f88-b8f8-ddddec6873f8

License

vcloudtools is released under the MIT license, a copy of which can be found in LICENSE.

Something went wrong with that request. Please try again.