A simple yet powerful CloudStack API client for Python and the command-line.
Project description
A simple, yet powerful CloudStack API client for python and the command-line.
Python 2.7+ and 3.3+ support.
All present and future CloudStack API calls and parameters are supported.
Syntax highlight in the command-line client if Pygments is installed.
BSD license.
Installation
pip install cs
Usage
In Python:
from cs import CloudStack
cs = CloudStack(endpoint='https://api.exoscale.ch/compute',
key='cloudstack api key',
secret='cloudstack api secret')
vms = cs.listVirtualMachines()
cs.createSecurityGroup(name='web', description='HTTP traffic')
From the command-line, this requires some configuration:
cat $HOME/.cloudstack.ini [cloudstack] endpoint = https://api.exoscale.ch/compute key = cloudstack api key secret = cloudstack api secret
Then:
$ cs listVirtualMachines
{
"count": 1,
"virtualmachine": [
{
"account": "...",
...
}
]
}
$ cs authorizeSecurityGroupIngress \
cidrlist="0.0.0.0/0" endport=443 startport=443 \
securitygroupname="blah blah" protocol=tcp
The command-line client polls when async results are returned. To disable polling, use the --async flag.
Configuration is read from several locations, in the following order:
The CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY and CLOUDSTACK_SECRET environment variables,
A CLOUDSTACK_CONFIG environment variable pointing to an .ini file,
A cloudstack.ini file in the current working directory,
A .cloudstack.ini file in the home directory.
To use that configuration scheme from your Python code:
from cs import CloudStack, read_config cs = CloudStack(**read_config())
Note that read_config() can raise SystemExit if no configuration is found.
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
File details
Details for the file cs-0.5.0.tar.gz.
File metadata
- Download URL: cs-0.5.0.tar.gz
- Upload date:
- Size: 4.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 455fcb73d8591ecb946cdcac8e36c9897b4ff9dc50e8d0a32134a59b5b3e8690 |
|
| MD5 | 31c5c3048959e8e56891514f658b07a8 |
|
| BLAKE2b-256 | bccb83823b41fb79535226d1d9f57781ac9906fc9f919d5889fb7fe6fc49892e |
File details
Details for the file cs-0.5.0-py2.py3-none-any.whl.
File metadata
- Download URL: cs-0.5.0-py2.py3-none-any.whl
- Upload date:
- Size: 6.1 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d73724b75841c39bec144147481be56dd53d72bf3bad134609b16da61996dd8b |
|
| MD5 | fd4d0d7e5c534ab55b2506bcd5c5498e |
|
| BLAKE2b-256 | 4298424f54497a4b71f368082457995f875509e8bc29f61df2ac68316d6343a5 |
