A CloudStack API client written in Ruby.
Install the cloudstack_client gem:
$ gem install cloudstack_client
- Access to the whole CloudStack-API from Ruby
- Interactive console for playing with the CloudStack API:
cloudstack_client console
- Dynamically builds API methods based on the listApis function of CloudStack
- Command names are converted to match Ruby naming conventions (i.e. ListVirtualMachines becomes list_virtual_machines)
- Accepts Ruby Hash arguments passed to commands as options (i.e. list_all: true becomes listall=true)
- Assure all required arguments are passed
- Removes unsupported arguments and arguments with nil values from commands
require "cloudstack_client"
cs = CloudstackClient::Client.new(
"https://cloudstack.local/client/api",
"API_KEY",
"SECRET_KEY"
)
cs.list_virtual_machines(state: "running").each do |vm|
puts vm["name"]
end
Load API definition file from an alternative path and set the version:
cs = CloudstackClient::Client.new(
"https://cloudstack.local/client/api",
"API_KEY",
"SECRET_KEY",
{
api_path: "~/cloudstack",
api_version: "4.15"
}
)
...or load the API definition directly from a file:
cs = CloudstackClient::Client.new(
"https://cloudstack.local/client/api",
"API_KEY",
"API_SECRET",
{ api_file: "~/cloudstack/4.15.json.gz" }
)
The configuration module of CloudstackClient makes it easy to load CloudStack API settings from configuration files.
require "cloudstack_client"
require "cloudstack_client/configuration"
# looks for ~/.cloudstack.yml per default
config = CloudstackClient::Configuration.load
cs = CloudstackClient::Client.new(config[:url], config[:api_key], config[:secret_key])
Configuration files support multiple environments (i.e. ~/.cloudstack.yml
):
# default environment
:default: production
# production environment
production:
:url: "https://my-cloudstack-server/client/api/"
:api_key: "cloudstack-api-key"
:secret_key: "cloudstack-api-secret"
# test environment
test:
:url: "http://my-cloudstack-testserver/client/api/"
:api_key: "cloudstack-api-key"
:secret_key: "cloudstack-api-secret"
cloudstack_client comes with an interactive console.
$ cloudstack_client console -e prod
prod >> list_virtual_machines
New API definitions can be generated using the list_apis
command.
# running against a CloudStack 4.15 API endpoint:
$ cloudstack_client list_apis > data/4.15.json
$ gzip data/4.15.json
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Copyright (c) 2014-2021, Nik Wolfgramm
Released under the MIT License. See the LICENSE file for further details.