cloudstack_client 0.2.10

data/lib/cloudstack_client/commands/iso.rb

@@ -0,0 +1,64 @@
+module CloudstackClient
+
+	module Iso
+
+		##
+    # Lists all isos that match the specified filter.
+    #
+    # Allowable filter values are:
+    #
+    # * featured - isos that are featured and are public
+    # * self - isos that have been registered/created by the owner
+    # * self-executable - isos that have been registered/created by the owner that can be used to deploy a new VM
+    # * executable - all isos that can be used to deploy a new VM
+    # * community - isos that are public
+
+    def list_isos(args = {})
+      filter = args[:filter] || 'featured'
+      params = {
+          'command' => 'listIsos',
+          'isofilter' => filter
+      }
+      params['projectid'] = args[:project_id] if args[:project_id]
+      params['zoneid'] = args[:zone_id] if args[:zone_id]
+      if args[:listall]
+        params['listall'] = true
+        params['isrecursive'] = true
+      end
+      
+      json = send_request(params)
+      json['iso'] || []
+    end
+
+    ##
+    # Finds the template with the specified name.
+
+    def get_iso(name)
+
+      # TODO: use name parameter
+      # listIsos in CloudStack 2.2 doesn't seem to work
+      # when the name parameter is specified. When this is fixed,
+      # the name parameter should be added to the request.
+      params = {
+          'command' => 'listIsos',
+          'isoFilter' => 'executable'
+      }
+      json = send_request(params)
+
+      isos = json['iso']
+      if !isos then
+        return nil
+      end
+
+      isos.each { |t|
+        if t['name'] == name then
+          return t
+        end
+      }
+
+      nil
+    end
+
+	end
+
+end

data/lib/cloudstack_client/commands/job.rb

@@ -0,0 +1,29 @@
+module CloudstackClient
+
+	module Job
+
+		##
+    # Retrieves the current status of asynchronous job.
+
+    def query_job(id)
+      params = {
+          'command' => 'queryAsyncJobResult',
+          'jobid' => id,
+      }
+      send_request(params)
+    end
+
+    ##
+    # Lists all pending asynchronous jobs for the account.
+
+    def list_jobs(opts = {})
+      params = {
+          'command' => 'listAsyncJobs'
+      }
+      params['listall'] = true if opts[:listall]
+      send_request(params)['asyncjobs']
+    end
+
+	end
+
+end

data/lib/cloudstack_client/commands/load_balancer_rule.rb

@@ -0,0 +1,61 @@
+module CloudstackClient
+
+	module LoadBalancerRule
+
+		##
+    # List loadbalancer rules
+
+    def list_load_balancer_rules(options = {})    
+      params = {
+        'command' => 'listLoadBalancerRules',
+      }
+      params['name'] = options[:name] if options[:name]
+
+      if options[:project_name]
+        project = get_project(options[:project_name])
+        params['projectid'] = project['id']
+      end
+
+      json = send_request(params)
+      json['loadbalancerrule'] || []
+    end
+
+    ##
+    # Creates a load balancing rule.
+
+    def create_load_balancer_rule(name, publicip, private_port, public_port, options = {})
+      params = {
+          'command' => 'createLoadBalancerRule',
+          'name' => name,
+          'privateport' => private_port,
+          'publicport' => public_port,
+          'publicipid' => get_public_ip_address(publicip)['id']
+      }
+      params['algorithm'] = options[:algorithm] || 'roundrobin'
+      params['openfirewall'] = options[:openfirewall] || true
+
+      json = send_async_request(params)
+      json['LoadBalancerRule']
+    end
+
+    ##
+    # Assigns virtual machine or a list of virtual machines to a load balancer rule.
+
+    def assign_to_load_balancer_rule(name, vm_names)
+      id = list_load_balancer_rules(name).first['id']
+
+      vm_ids = vm_names.map do |vm|
+        get_server(vm)['id']
+      end
+
+      params = {
+          'command' => 'assignToLoadBalancerRule',
+          'id' => id,
+          'virtualmachineids' => vm_ids.join(',')
+      }
+      json = send_async_request(params)
+    end
+
+	end
+
+end

data/lib/cloudstack_client/commands/network.rb

@@ -0,0 +1,128 @@
+module CloudstackClient
+
+	module Network
+
+    ##
+    # Finds the network with the specified name.
+
+    def networkid_to_name(id, project_id=nil)
+      params = {
+          'command' => 'listNetworks',
+          'id' => id
+      }
+      params['projectid'] = project_id if project_id
+      json = send_request(params)
+
+      json['network'] ? json['network'].first['name'] : nil
+    end
+
+		##
+    # Finds the network with the specified name.
+
+    def get_network(name, project_id = nil)
+      params = {
+          'command' => 'listNetworks',
+          'listall' => true
+      }
+      params['projectid'] = project_id if project_id
+      json = send_request(params)
+
+      networks = json['network']
+      return nil unless networks
+
+      networks.each { |n|
+        if n['name'] == name then
+          return n
+        end
+      }
+      nil
+    end
+
+    ##
+    # Finds the default network.
+
+    def get_default_network(zone = nil)
+      params = {
+          'command' => 'listNetworks',
+          'isDefault' => true
+      }
+      if zone
+        params['zoneid'] = get_zone(zone)['id']
+      end
+      json = send_request(params)
+
+      networks = json['network']
+      return nil if !networks || networks.empty?
+      return networks.first if networks.length == 1
+
+      networks.each { |n|
+        if n['type'] == 'Direct' then
+          return n
+        end
+      }
+      nil
+    end
+
+    ##
+    # Lists all available networks.
+
+    def list_networks(args = {})
+      params = {
+        'command' => 'listNetworks',
+        'listall' => true,
+      }
+      params['projectid'] = args[:project_id] if args[:project_id]
+      params['zoneid'] = args[:zone_id] if args[:zone_id]
+      params['isDefault'] = true if args[:isdefault]
+      if args[:account]
+        domain = list_accounts(name: args[:account])
+        if domain.size > 0
+          params['account'] = args[:account]
+          params['domainid'] = domain.first["domainid"]
+        else
+          puts "Account #{args[:account]} not found."
+        end
+      end
+      json = send_request(params)
+      json['network'] || []
+    end
+
+    ##
+    # Delete network.
+
+    def delete_network(id)
+      params = {
+        'command' => 'deleteNetwork',
+        'id' => id,
+      }
+      p json = send_async_request(params)
+      json['network']
+    end
+
+    ##
+    # Restart network.
+
+    def restart_network(id, cleanup = false)
+      params = {
+        'command' => 'restartNetwork',
+        'id' => id,
+        'cleanup' => cleanup,
+      }
+      p json = send_async_request(params)
+      json['network']
+    end
+
+    ##
+    # Lists all physical networks.
+
+    def list_physical_networks
+      params = {
+          'command' => 'listPhysicalNetworks',
+      }
+      json = send_request(params)
+      json['physicalnetwork'] || []
+    end
+
+	end
+
+end

data/lib/cloudstack_client/commands/pod.rb

@@ -0,0 +1,19 @@
+module CloudstackClient
+
+	module Pod
+
+		##
+    # Lists pods.
+
+    def list_pods(args = {})
+      params = {
+        'command' => 'listPods',
+      }
+
+      json = send_request(params)
+      json['pod'] || []
+    end
+
+	end
+
+end

data/lib/cloudstack_client/commands/port_forwarding_rule.rb

@@ -0,0 +1,49 @@
+module CloudstackClient
+
+	module PortForwardingRule
+
+		##
+    # Lists all port forwarding rules.
+
+    def list_port_forwarding_rules(ip_address_id=nil, project_id)
+      params = {
+          'command' => 'listPortForwardingRules',
+          'listall' => true,
+          'isrecursive' => true
+      }
+      params['ipAddressId'] = ip_address_id if ip_address_id
+      params['projectid'] = project_id if project_id
+      json = send_request(params)
+      json['portforwardingrule'] || []
+    end
+
+    ##
+    # Gets the SSH port forwarding rule for the specified server.
+
+    def get_ssh_port_forwarding_rule(server, cached_rules=nil)
+      rules = cached_rules || list_port_forwarding_rules || []
+      rules.find_all { |r|
+        r['virtualmachineid'] == server['id'] &&
+            r['privateport'] == '22'&&
+            r['publicport'] == '22'
+      }.first
+    end
+
+    ##
+    # Creates a port forwarding rule.
+
+    def create_port_forwarding_rule(ip_address_id, private_port, protocol, public_port, virtual_machine_id, async = true)
+      params = {
+          'command' => 'createPortForwardingRule',
+          'ipAddressId' => ip_address_id,
+          'privatePort' => private_port,
+          'protocol' => protocol,
+          'publicPort' => public_port,
+          'virtualMachineId' => virtual_machine_id
+      }
+      async ? send_async_request(params)['portforwardingrule'] : send_request(params)
+    end
+
+	end
+
+end

data/lib/cloudstack_client/commands/project.rb

@@ -0,0 +1,32 @@
+module CloudstackClient
+
+	module Project
+
+		##
+    # Get project by name.
+
+    def get_project(name)
+      params = {
+          'command' => 'listProjects',
+          'name' => name,
+          'listall' => true,
+      }
+      json = send_request(params)
+      json['project'] ? json['project'].first : nil
+    end
+
+    ##
+    # Lists projects.
+            
+    def list_projects
+      params = {
+          'command' => 'listProjects',
+          'listall' => true,
+      }
+      json = send_request(params)
+      json['project'] || []
+    end
+
+	end
+
+end

data/lib/cloudstack_client/commands/router.rb

@@ -0,0 +1,89 @@
+module CloudstackClient
+
+	module Router
+
+    ##
+    # Get a router with a given name.
+
+    def get_router(name, project_id = nil)
+      params = {
+          'command' => 'listRouters',
+          'listall' => 'true',
+          'name' => name
+      }
+      params['projectid'] = project_id if project_id 
+
+      json = send_request(params)
+      json['router'] ? json['router'].first : nil
+    end
+
+		##
+    # Lists all virtual routers.
+
+    def list_routers(args = {:account => nil, :zone => nil, :projectid => nil, :status => nil, :name => nil})
+      params = {
+          'command' => 'listRouters',
+          'listall' => 'true',
+          'isrecursive' => 'true'
+      }
+      if args[:zone]
+        zone = get_zone(args[:zone])
+        unless zone 
+          puts "Error: Zone #{args[:zone]} not found"
+          exit 1
+        end
+        params['zoneid'] = zone['id']  
+      end
+      params['projectid'] = args[:projectid] if args[:projectid]
+      params['state'] = args[:status] if args[:status]
+      params['name'] = args[:name] if args[:name]
+      if args[:account]
+        account = list_accounts({name: args[:account]}).first
+        unless account
+          puts "Error: Account #{args[:account]} not found."
+          exit 1
+        end
+        params['domainid'] = account["domainid"]
+        params['account'] = args[:account]
+      end
+
+      json = send_request(params)
+      json['router'] || []
+    end
+
+    ##
+    # Destroy virtual router.
+
+    def destroy_router(id, opts = {async: true})
+      params = {
+        'command' => 'destroyRouter',
+        'id' => id
+      }
+      opts[:async] ? send_async_request(params)['router'] : send_request(params)
+    end
+
+    ##
+    # Start virtual router.
+
+    def start_router(id, opts = {async: true})
+      params = {
+        'command' => 'startRouter',
+        'id' => id
+      }
+      opts[:async] ? send_async_request(params)['router'] : send_request(params)
+    end
+
+    ##
+    # Stop virtual router.
+
+    def stop_router(id, opts = {async: true})
+      params = {
+        'command' => 'stopRouter',
+        'id' => id
+      }
+      opts[:async] ? send_async_request(params)['router'] : send_request(params)
+    end
+
+	end
+
+end