cloudcontrol_sdk 0.3.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 589fa5ceedb8772df6be667c83a8e9b9dbd59a87f84b7bdf6f2c00ab4602bde7
+  data.tar.gz: e44127510cd833d8b72e9b874a50795814d0dca11fdb55b0f955e6bd0ca2a176
+SHA512:
+  metadata.gz: d146dc22a04375aea377c08491446f08406b8f0944e0197d7863021075bce3b819b9104f788fb658def3dfc9dbf79f77786a1f0d57bfdce3be9b6f17fbda83f3
+  data.tar.gz: 88c0e99bea294228c5e700037e8811ae34bcf7a31f9670294d6110ff49c3229c12b365640cb0a9fa717a9492e1fa7795b9900dd9c564bb29f50b17278dc2797c

data/.gitignore

@@ -0,0 +1,5 @@
+Gemfile.lock
+*.swp
+*.gem
+credentials.rb
+

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in opsource.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 tintoy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,34 @@
+## Cloud Control Ruby gem 
+
+Cloud Control Cloud API gem designed for easy extensibility.
+Note: This gem at present ONLY provides read functionality across the API. This is so that the Chef Inspec plugin written for Cloud Control can operate successfully. All the existing gems for this are 6 years old and appear abandoned, so I'm not sure there is much of a demand for this. There is also a lot of work to change the API calls to leverage MCP 2.0 apis.
+
+
+
+### Install
+
+either install as a gem via Bundler
+```
+gem install cloudcontrol_sdk
+```
+
+
+
+### Usage
+
+```
+require "cloudcontrol_sdk"
+api_base      = CloudControl::Client::API_URL[:au]
+dev_org_id    = 'my-super-secret-org-numbersandletters'
+dev_user      = 'me'
+dev_password  = 'very secret'
+
+c = CloudControl::Client.new(api_base, dev_org_id, dev_user, dev_password)
+
+server = c.server.list(name: 'myfavoritevm')
+```
+
+
+
+Based on : https://github.com/udayakiran/opsource.
+

data/cloudcontrol.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "cloudcontrol/version"
+
+Gem::Specification.new do |s|
+  s.name        = "cloudcontrol_sdk"
+  s.version     = CloudControl::VERSION
+  s.authors     = ["Nigel Wright"]
+  s.email       = ["nigel.wright@global.ntt"]
+  s.licenses 	= ['MIT']
+  s.homepage    = ""
+  s.summary     = %q{NTT Cloud Control REST API client gem}
+  s.description = %q{SDK to access NTT Cloud Control api'}
+
+  s.rubyforge_project = "cloudcontrol"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'i18n'
+  s.add_dependency 'activesupport'
+  s.add_dependency 'typhoeus'
+  s.add_dependency 'xml-simple'
+  s.add_dependency 'hashie'
+  s.add_dependency 'colorize'
+end

data/lib/cloudcontrol.rb

@@ -0,0 +1,22 @@
+require 'active_support/core_ext/object'
+require 'active_support/core_ext/string'
+require 'typhoeus'
+require 'xmlsimple'
+require 'hashie'
+
+require 'cloudcontrol/version.rb'
+require 'cloudcontrol/exceptions.rb'
+
+require 'cloudcontrol/connection.rb'
+require 'cloudcontrol/params.rb'
+# require 'cloudcontrol/xml.rb'
+require 'cloudcontrol/client.rb'
+
+require 'cloudcontrol/api/core.rb'
+# require 'cloudcontrol/api/directory.rb'
+require 'cloudcontrol/api/image.rb'
+require 'cloudcontrol/api/network.rb'
+require 'cloudcontrol/api/server.rb'
+require 'cloudcontrol/api/vip.rb'
+require 'cloudcontrol/api/account.rb'
+require 'cloudcontrol/api/report.rb'

data/lib/cloudcontrol/api/account.rb

@@ -0,0 +1,13 @@
+module CloudControl::API
+  class Account < Core
+    def myaccount()
+      endpoint "/myaccount"
+      get
+    end
+
+    def list()
+      org_endpoint "/account"
+      get
+    end
+  end
+end

data/lib/cloudcontrol/api/core.rb

@@ -0,0 +1,127 @@
+module CloudControl::API
+  class Core
+    attr_reader :client
+    def initialize(client)
+      @client = client
+    end
+
+
+    ### client methods
+
+    def log(*args)
+      @client.log(*args)
+    end
+
+    def org_id
+      @client.org_id
+    end
+
+
+    ### request options
+
+    def endpoint(e)
+      @endpoint = e
+    end
+
+    def org_endpoint(e)
+      endpoint("/#{org_id}" + e)
+    end
+
+    def query_params(q)
+      @query_params = q
+    end
+
+    def xml_params(x)
+      @xml_params = x
+    end
+
+    def simple_params(x)
+      @simple_params = x
+    end
+
+    ### perform request
+
+    def get
+      perform :get
+    end
+
+    def post
+      perform :post
+    end
+
+    def get_simple
+        perform :get, true
+    end
+
+    def post_simple
+        perform :post, true
+    end
+
+    #do not parse response if simple
+    #if simple, post body is also simple...
+    def perform(method, simple=false)
+      if simple
+        request = @client.build_request(method, @endpoint, request_query_string, request_simple_body, false)
+      else
+        request = @client.build_request(method, @endpoint, request_query_string, request_xml_body)
+      end
+      response = @client.perform_request(request)
+
+      @client.log_response(request, response)
+
+      # return parsed object if it's good
+      if response.success?
+        if simple
+          result = response.body
+        else
+          result = @client.parse_response_xml_body(response.body)
+          if result['total_count']
+            log "#{result['total_count']} total", :yellow, :bold
+            result.delete('page_size')
+            result.delete('total_count')
+            result.delete('page_count')
+            result.delete('page_number')
+          end
+          # unwind some arrays of elements
+          result.values.count == 1 ? result.values.first : result
+        end
+      else
+        {}
+      end
+    end
+
+    def single(results)
+      if results.is_a? Array
+        results.first
+      else
+        results
+      end
+    end
+
+
+    ### build request
+
+    def request_query_string
+      fparams = @client.filter_params || {}
+      qparams = @query_params || {}
+      params = fparams.merge(qparams)
+      @client.url_query(params) if params.present?
+    end
+
+    def request_xml_body
+      return if @xml_params.blank?
+      schema = @xml_params.delete(:schema)
+      tag = @xml_params.delete(:tag)
+
+      body = @client.build_request_xml_body(schema, tag, @xml_params)
+      log(body, :green)
+      body
+    end
+    def request_simple_body
+      return if @simple_params.blank?
+      body = @client.build_request_simple_body(@simple_params)
+      log(body, :green)
+      body
+    end
+  end
+end

data/lib/cloudcontrol/api/image.rb

@@ -0,0 +1,24 @@
+module CloudControl::API
+  class Image < Core
+    def server_list
+      endpoint '/base/image'
+      get
+    end
+
+    def deployed_list(options = {})
+      endpoint "/#{org_id}/image/deployed"
+      query_params options
+      get
+    end
+
+    def show_by_name(name, options = {})
+      options[:name] = name
+      single(deployed_list(options))
+    end
+
+    def show(image_id)
+      endpoint "/#{org_id}/image/#{image_id}"
+      get
+    end
+  end
+end

data/lib/cloudcontrol/api/infrastructure.rb

@@ -0,0 +1,16 @@
+module CloudControl::API
+    class Infrastructure < Core
+        def list_regions(options = {})
+            endpoint "/#{org_id}/infrastructure/geographicRegion"
+            query_params options
+            get
+        end
+
+        def list_datacenters(options = {})
+          endpoint "/#{org_id}/infrastructure/datacenter"
+          query_params options
+          get
+        end
+
+    end
+end

data/lib/cloudcontrol/api/network.rb

@@ -0,0 +1,65 @@
+module CloudControl::API
+  class Network < Core
+    def list
+      org_endpoint '/network'
+      get
+    end
+
+    def create(name, description="", datacenter=@client.datacenter)
+      org_endpoint "/networkWithLocation"
+      xml_params(schema: "network", tag: "NewNetworkWithLocation", name: name, description: description, location: datacenter)
+      post
+    end
+
+    def list_with_location
+      org_endpoint "/networkWithLocation"
+      get
+    end
+
+    def list_in_location(location_id)
+      org_endpoint "/networkWithLocation/#{location_id}"
+      get
+    end
+
+    def show(network_id)
+      list_with_location.find {|n| n.id == network_id}
+    end
+
+    def show_by_name(name)
+     list_with_location.find {|n| n.name == name}
+    end
+
+    def natrule_list(network_id)
+      org_endpoint "/network/#{network_id}/natrule"
+      get
+    end
+
+    # name = "10.147.15.11", source_ip = "10.147.15.11"
+    def natrule_create(network_id, name, source_ip)
+      org_endpoint "/network/#{network_id}/natrule"
+      xml_params(schema: "network", tag: "NatRule", name: name, source_ip: source_ip)
+      post
+    end
+
+    def natrule_delete(network_id, natrule_id)
+      org_endpoint "/network/#{network_id}/natrule/#{natrule_id}?delete"
+      get
+    end
+
+    def aclrule_list(network_id)
+      org_endpoint "/network/#{network_id}/aclrule"
+      get
+    end
+
+    def aclrule_delete(network_id, aclrule_id)
+      org_endpoint "/network/#{network_id}/aclrule/#{aclrule_id}?delete"
+      get
+    end
+
+    def aclrule_create(network_id, name, position, inbound, protocol, port, allow)
+      org_endpoint "/network/#{network_id}/aclrule"
+      xml_params(schema: "network", tag: "AclRule", name: name, position: position, action: (allow ? "PERMIT" : "DENY"), protocol: protocol, source_ip_range: {}, destination_ip_range: {}, port_range: {type: "EQUAL_TO", port1: port}, type: (inbound ? "OUTSIDE_ACL" : "INSIDE_ACL"))
+      post
+    end
+  end
+end

data/lib/cloudcontrol/api/report.rb

@@ -0,0 +1,24 @@
+module CloudControl::API
+    class Report < Core
+        def auditlog(start_date, end_date)
+            start = start_date.strftime("%Y-%m-%d")
+            stop = end_date.strftime("%Y-%m-%d")
+            org_endpoint "/auditlog?startDate=#{start}&endDate=#{stop}"
+            get_simple
+        end
+
+        def summary_usage(start_date, end_date)
+            start = start_date.strftime("%Y-%m-%d")
+            stop = end_date.strftime("%Y-%m-%d")
+            org_endpoint "/report/usage?startDate=#{start}&endDate=#{stop}"
+            get_simple
+        end
+
+        def detailed_usage(start_date, end_date)
+            start = start_date.strftime("%Y-%m-%d")
+            stop = end_date.strftime("%Y-%m-%d")
+            org_endpoint "/report/usageDetailed?startDate=#{start}&endDate=#{stop}"
+            get_simple
+        end
+    end
+end

data/lib/cloudcontrol/api/server.rb

@@ -0,0 +1,118 @@
+module CloudControl::API
+  class Server < Core
+
+
+    def list(options = {})
+      endpoint "/#{org_id}/server/server"
+      query_params options
+      get
+    end
+    
+    def show(server_id, options = {})
+      endpoint "/#{org_id}/server/server/#{server_id}"
+      get
+    end
+
+    def show_by_name(name, options = {})
+      options[:name] = name
+      single(list(options))
+    end
+
+    def show_by_id(id, options = {})
+      options[:id] = id
+      single(list(options))
+    end
+
+    
+    def list_nics(vlan_id, options = {})
+      endpoint "/#{org_id}/server/nic"
+      get
+    end
+
+    def list_anti_affinity(target_id, options = {})
+      endpoint "/#{org_id}/server/nic"
+      get
+    end
+
+    def show_by_ip(ip, options = {})
+      options[:private_ip] = ip
+      single(list(options))
+    end
+  
+    # def create(name, 
+    #            description, 
+    #            network_id, 
+    #            image_id, 
+    #            administrator_password=@client.default_password)
+    #   org_endpoint "/server"
+
+    #   xml_params(
+    #     tag: "Server",
+    #     schema: "server",
+    #     name: name,
+    #     description: description,
+    #     vlan_resource_path: "/oec/#{org_id}/network/#{network_id}",
+    #     image_resource_path: "/oec/base/image/#{image_id}",
+    #     is_started: 'true',
+    #     administrator_password: administrator_password
+    #   )
+    #   post
+    # end
+
+    # def delete(server_id)
+    #   org_endpoint "/server/#{server_id}?delete"
+    #   get
+    # end
+
+    # # memory in MB, ust be multiple of 1024
+    # def modify(server_id, name = nil, description = nil, cpu_count = nil, memory = nil)
+    #   query_params(
+    #     name: name,
+    #     description: description,
+    #     cpu_count: cpu_count,
+    #     memory: memory
+    #   )
+    #   org_endpoint "/server/#{server_id}"
+    #   post
+    # end
+
+    # def start(server_id)
+    #   org_endpoint "/server/#{server_id}?start"
+    #   get
+    # end
+
+    # def shutdown(server_id)
+    #   org_endpoint "/server/#{server_id}?shutdown"
+    #   get
+    # end
+
+    # def poweroff(server_id)
+    #   org_endpoint "/server/#{server_id}?poweroff"
+    #   get
+    # end
+
+    # def reboot(server_id)
+    #   org_endpoint "/server/#{server_id}?reboot"
+    #   get
+    # end
+
+    # def reset(server_id)
+    #   org_endpoint "/server/#{server_id}?reset"
+    #   get
+    # end
+
+    # # amount is # of GBs
+    # def add_storage(server_id, amount)
+    #   org_endpoint "/server/#{server_id}?addLocalStorage"
+    #   query_params(amount: amount)
+    #   get
+    # end
+
+    # def remove_storage(server_id, disk_id)
+    #   org_endpoint "/server/#{server_id}/disk/#{disk_id}?delete"
+    #   get
+    # end
+
+  end
+end
+

data/lib/cloudcontrol/api/vip.rb

@@ -0,0 +1,125 @@
+module CloudControl::API
+  class VIP < Core
+
+  # Real Server section
+    def real_servers_list (network_id)
+      org_endpoint "/network/#{network_id}/realServer"
+      get
+    end
+
+    # Examples name = RealServer1, server_id = "415a7f70-1008-42a3-8375-5dcf52636cc5", in_service = true/false
+    def real_server_create (network_id, name, server_id, in_service)
+      org_endpoint "/network/#{network_id}/realServer"
+      xml_params(tag: "NewRealServer", schema: "vip", name: name, server_id: server_id, in_service: in_service)
+      post
+    end
+
+
+    def real_server_delete (network_id, rserver_id)
+      org_endpoint "/network/#{network_id}/realServer/#{rserver_id}?delete"
+      get
+    end
+
+
+    def real_server_modify (network_id, rserver_id, in_service)
+      org_endpoint "/network/#{network_id}/realServer/#{rserver_id}"
+      xml_params(in_service: in_service)
+      post
+    end
+
+  # Probe section
+    def probe_list (network_id)
+      org_endpoint "/network/#{network_id}/probe"
+      get
+    end
+
+    # Note this is for TCP, UDP & ICMP only additional xml fields need to be added to be complete
+    # Examples name = Probe1, type = TCP, probeIntervalSeconds = "60", errorCountBeforeServerFail = "5" maxReplyWaitSeconds = "10"
+    def probe_create
+      org_endpoint "/network/#{network_id}/probe"
+      xml_params(name: name, type: type, probeIntervalSeconds: probeIntervalSeconds, errorCountBeforeServerFail: errorCountBeforeServerFail, successCountBeforeServerEnable: successCountBeforeServerEnable, failedProbeIntervalSeconds: failedProbeIntervalSeconds, maxReplyWaitSeconds: maxReplyWaitSeconds)
+      post
+    end
+
+
+    def probe_delete (network_id, probe_id)
+      org_endpoint "/network/#{network_id}/probe/{probe_id}?delete"
+      get
+    end
+
+
+  # Server Farm Section
+    def server_farm_list (network_id)
+      org_endpoint "/network/#{network_id}/serverFarm"
+      get
+    end
+
+    def server_farm_details (network_id, server_farm_id)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}"
+      get
+    end
+
+    def server_farm_create (network_id, name, real_server_id, port, predictor)
+      if ["ROUND_ROBIN", "LEAST_CONNECTIONS"].include? predictor
+        org_endpoint "/network/#{network_id}/serverFarm"
+        xml_params(schema: "vip", tag: "NewServerFarm", name: name, predictor: predictor, real_server: {id: real_server_id, port: port})
+        post
+      else
+        raise "Unknown predictor: #{predictor}"
+      end
+    end
+
+    def server_farm_delete (network_id, server_farm_id)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}?delete"
+      get
+    end
+
+    # Examples realServerId = "RealServer1", realSeverPort = "80"
+    def real_server_to_server_farm (network_id, server_farm_id, real_server_id, real_server_port)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}/addRealServer"
+      simple_params(real_server_id: real_server_id, real_server_port: real_server_port)
+      post_simple
+    end
+
+    # Examples realServerId = "RealServer1", realSeverPort = "80"
+    def real_server_from_server_farm (network_id, server_farm_id, real_server_id, real_server_port)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}/removeRealServer"
+      simple_params(real_server_id: real_server_id, real_server_port: real_server_port)
+      post_simple
+    end
+
+
+    # Examples probe_id = TCP1
+    def probe_to_server_farm (network_id, server_farm_id, probe_id)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}/addProbe"
+      xml_params(probe_id: probe_id)
+      post
+    end
+
+    # Examples probe_id = TCP1
+    def probe_from_server_farm (network_id, server_farm_id, probe_id)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}/removeProbe"
+      xml_params(probe_id: probe_id)
+      post
+    end
+
+    # Examples predictor= LEAST_CONNECTIONS | ROUND_ROBIN
+    def server_farm_predictor(network_id, server_farm_id, predictor)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}"
+      xml_params(predictor: predictor)
+      post
+    end
+
+    def vip_list(network_id)
+      org_endpoint "/network/#{network_id}/vip"
+      get
+    end
+
+    def vip_create(network_id, name, port, protocol, server_farm_id)
+      org_endpoint "/network/#{network_id}/vip"
+      xml_params(schema: "vip", tag: "NewVip", name: name, port: port, protocol: protocol, vip_target_type: "SERVER_FARM", vip_target_id: server_farm_id, reply_to_icmp: true, in_service: true)
+      post
+    end
+
+  end
+end

data/lib/cloudcontrol/client.rb

@@ -0,0 +1,97 @@
+module CloudControl
+  class Client
+    include CloudControl::Connection
+    include CloudControl::Params
+    # include CloudControl::XML
+
+    attr_reader :api_base, :org_id, :username, :password
+    attr_reader :image, :network, :server, :account, :report
+    attr_reader :datacenter, :default_password
+
+    ### FILTERS
+    # client.page_size = 10
+    # client.page_number = 1
+    # client.order_by = 'location,created.DESCENDING'
+    # client.filter_with = {location: %w(NA1 NA2), key: 'value'}
+    attr_accessor :silent, :colors # log setting
+    attr_accessor :page_size, :page_number, :order_by, :filter_with
+
+    IMAGES = {suse_ent_64: "d4edfe22-e2f0-11e2-84e5-180373fb68df", ubuntu_14_04: "abef3a94-3361-4ce4-a937-5e587042586a", ubuntu_12_04: "d4ed6d40-e2f0-11e2-84e5-180373fb68df", ubuntu_10_04: "d4edba02-e2f0-11e2-84e5-180373fb68df"}
+    API_URL = {na: "https://api-na.dimensiondata.com/caas/2.8", 
+               eu: "https://api-eu.dimensiondata.com/caas/2.8", 
+               au: "https://api-au.dimensiondata.com/caas/2.8", 
+               mea: "https://api-mea.dimensiondata.com/caas/2.8", 
+               ap: "https://api-ap.dimensiondata.com/caas/2.8"}
+
+
+    def initialize(api_base, org_id, username, password, colors = true, silent = true)
+      @api_base = api_base
+      @org_id       = org_id
+      @username     = username
+      @password     = password
+      @colors = colors
+      @silent = silent
+
+      if @colors
+        require 'colorize'
+      end
+    end
+
+    # def directory
+    #   CloudControl::API::Directory.new(self)
+    # end
+
+    def image
+      CloudControl::API::Image.new(self)
+    end
+
+    def network
+      CloudControl::API::Network.new(self)
+    end
+
+    def server
+      CloudControl::API::Server.new(self)
+    end
+
+    def account
+      CloudControl::API::Account.new(self)
+    end
+
+    def report
+      CloudControl::API::Report.new(self)
+    end
+
+    def vip
+      CloudControl::API::VIP.new(self)
+    end
+
+    def filter_params
+      params = {}
+      params[:page_size] = @page_size if @page_size.present?
+      params[:page_number] = @page_number if @page_number.present?
+      params[:order_by] = @order_by if @order_by.present?
+
+      if @filter_with.present?
+        @filter_with.each do |k, val|
+          params[k.to_sym] = val
+        end
+      end
+      params
+    end
+
+    # mode: bold, underscore, default
+    def log_error(message, color=nil, mode=nil)
+	log message, color, mode, true
+    end
+    def log(message, color = nil, mode = nil, error=nil)
+      return if (@silent && (not error))
+      if @colors
+        color = color.to_sym if color
+        mode = mode.to_sym if mode
+        puts message.colorize(:color => color, :mode => mode)
+      else
+        puts message
+      end
+    end
+  end
+end

data/lib/cloudcontrol/connection.rb

@@ -0,0 +1,59 @@
+module CloudControl
+  module Connection
+    def build_request(type, endpoint, query = nil, body = nil, xml=true)
+      uri = api_base + endpoint
+      append_query(uri, query) if query
+
+      if xml
+        request = Typhoeus::Request.new(
+          uri,
+          method: type,
+          body: body,
+          userpwd: "#{@username}:#{@password}",
+            headers: { 'Content-Type' =>'text/xml', 'User-Agent' => 'ACP Ruby SDK' }
+        )
+      else
+        request = Typhoeus::Request.new(
+          uri,
+          method: type,
+          body: body,
+          userpwd: "#{@username}:#{@password}",
+            headers: {  'User-Agent' => 'ACP Ruby SDK' }
+        )
+      end
+    end
+
+    def append_query(uri, query)
+      if uri.include?('?')
+        uri << '&'
+      else
+        uri << '?'
+      end
+      uri << query
+    end
+
+
+    def perform_request(request)
+      log "\nrequesting #{request.url}...", :yellow
+      request.run
+    end
+
+    def log_response(request, response)
+      if response.success?
+        log "...........success!", :yellow
+      elsif response.timed_out?
+        log_error "ERROR\n-----", :red
+        log_error "got a time out"
+      elsif response.code == 0
+        # Could not get an http response, something's wrong.
+        log_error "ERROR\n-----", :red
+        log_error response.return_message
+      else
+        # Received a non-successful http response.
+        log_error "ERROR\n-----", :red
+        log_error "HTTP request failed: " + response.code.to_s, :red
+        log_error response.body, :yellow
+      end
+    end
+  end
+end

data/lib/cloudcontrol/exceptions.rb

@@ -0,0 +1,14 @@
+module CloudControl
+  module Exceptions
+    CODES = {
+      "REASON_10" => "Failure at network",
+      "REASON_20" => "Unrecoverable failure cause by a timeout.",
+      "REASON_250" => "Network does not exist for this organization.",
+      "REASON_320" => "Invalid Input Data - SourceIP must be a valid IPv4 address."
+    }
+
+    class ApiError < StandardError; end
+    class ConnectionError < StandardError; end
+    class RequestError < StandardError; end
+  end
+end

data/lib/cloudcontrol/params.rb

@@ -0,0 +1,62 @@
+module CloudControl
+  module Params
+    def url_query(params)
+      params = camelize_keys(params)
+      qitems = []
+      params.each do |k, vs|
+        vs = [vs].flatten.compact # remove nil values
+        vs.each {|v| qitems << "#{k}=#{v}"}
+      end
+      qitems.join('&')
+    end
+
+    def symbolize_keys(arg)
+      case arg
+      when Array
+        arg.map {  |elem| symbolize_keys elem }
+      when Hash
+        Hash[
+          arg.map {  |key, value|
+            k = key.is_a?(String) ? key.to_sym : key
+            v = symbolize_keys value
+            [k,v]
+          }]
+      else
+        arg
+      end
+    end
+
+    def underscore_keys(arg)
+      case arg
+      when Array
+        arg.map {  |elem| underscore_keys elem }
+      when Hash
+        Hash[
+          arg.map {  |key, value|
+            k = key.is_a?(String) ? key.underscore : key
+            v = underscore_keys value
+            [k,v]
+          }]
+      else
+        arg
+      end
+    end
+
+    def camelize_keys(arg)
+      case arg
+      when Array
+        arg.map {  |elem| camelize_keys elem }
+      when Hash
+        Hash[
+          arg.map {  |key, value|
+            k = key.is_a?(String) ? key.camelize(:lower) : key
+            k = key.is_a?(Symbol) ? key.to_s.camelize(:lower).to_sym : key
+            v = camelize_keys value
+            [k,v]
+          }]
+      else
+        arg
+      end
+    end
+  end
+end

data/lib/cloudcontrol/version.rb

@@ -0,0 +1,4 @@
+module CloudControl
+  VERSION = "0.3.5"
+
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: cloudcontrol_sdk
+version: !ruby/object:Gem::Version
+  version: 0.3.5
+platform: ruby
+authors:
+- Nigel Wright
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-11-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: xml-simple
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: SDK to access NTT Cloud Control api'
+email:
+- nigel.wright@global.ntt
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- cloudcontrol.gemspec
+- lib/cloudcontrol.rb
+- lib/cloudcontrol/api/account.rb
+- lib/cloudcontrol/api/core.rb
+- lib/cloudcontrol/api/image.rb
+- lib/cloudcontrol/api/infrastructure.rb
+- lib/cloudcontrol/api/network.rb
+- lib/cloudcontrol/api/report.rb
+- lib/cloudcontrol/api/server.rb
+- lib/cloudcontrol/api/vip.rb
+- lib/cloudcontrol/client.rb
+- lib/cloudcontrol/connection.rb
+- lib/cloudcontrol/exceptions.rb
+- lib/cloudcontrol/params.rb
+- lib/cloudcontrol/version.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: NTT Cloud Control REST API client gem
+test_files: []