Unofficial ruby bindings for VMware® vCloud Director's rest APIs.
Note: at this stage both v.1.5 and v.5.1 are supported. It defaults to v.5.1 but it's possible to specify api_version="1.5".
See vCloud API for details.
This code is BETA QUALITY.
This plugin is distributed as a Ruby Gem. To install it, run:
gem install vcloud-rest
Depending on your system's configuration, you may need to run this command with root privileges.
vcloud-rest is tested against ruby 2.0.0, 1.9.x and 1.8.7+.
- login/logout
- list/show Organizations
- show VDCs
- show Catalogs
- show Catalog Items
- create/start/stop/delete/show/reset/suspend/reboot vApps
- show VMs
- basic vApp network configuration
- basic VM network configuration
- basic VM Guest Customization configuration
- basic vApp compose capabilities
- basic vApp NAT port forwarding creation
- Catalog item upload with byterange upload and retry capabilities
- extend test coverage
- a lot more...
- nokogiri ~> 1.6.0
- rest-client ~> 1.6.7
- httpclient ~> 2.3.3
- ruby-progressbar ~> 1.1.1
For testing purpose:
- minitest (included in ruby 1.9)
- webmock
require 'vcloud-rest/connection'
conn = VCloudClient::Connection.new(HOST, USER, PASSWORD, ORG_NAME)
conn.login
conn.list_organizations
A (mostly complete) example can be found in
examples/example.rb
Simply run:
rake
Or:
ruby spec/connection_spec.rb
Note: in order to run tests with ruby 1.8.7+ you need to export RUBYOPT="rubygems"
Author:: Stefano Tortarolo stefano.tortarolo@gmail.com
Copyright:: Copyright (c) 2012-2013 License:: Apache License, Version 2.0
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
This code was inspired by knife-cloudstack.