1and1 1.1

data/examples/shared_storage_examples.rb

@@ -0,0 +1,108 @@
+# List all shared storages on your account
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.list
+
+puts JSON.pretty_generate(response)
+
+
+
+# Create a shared storage
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.create(name: 'Test SS', description: 'Example Desc',
+  size: 200)
+
+puts JSON.pretty_generate(response)
+
+
+
+# Retrieve a shared storage's current specs
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.get(shared_storage_id: '<SHARED-STORAGE-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Modify a shared storage
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.modify(shared_storage_id: '<SHARED-STORAGE-ID>',
+  name: 'Test SS Rename', size: 400)
+
+puts JSON.pretty_generate(response)
+
+
+
+# Delete a shared storage
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.delete(shared_storage_id: '<SHARED-STORAGE-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Add servers to a shared storage
+shared_storage = OneAndOne::SharedStorage.new()
+
+server1 = {
+  'id' => '<SERVER-ID>',
+  'rights' => 'RW'
+}
+
+servers = [server1]
+
+response = shared_storage.add_servers(shared_storage_id: '<SHARED-STORAGE-ID>',
+  servers: servers)
+
+puts JSON.pretty_generate(response)
+
+
+
+# List a shared storage's servers
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.servers(shared_storage_id: '<SHARED-STORAGE-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Retrieve information about a shared storage's server
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.server(shared_storage_id: '<SHARED-STORAGE-ID>',
+  server_id: '<SERVER-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Remove a server from a shared storage
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.remove_server(shared_storage_id: '<SHARED-STORAGE-ID>',
+  server_id: '<SERVER-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Retrieve the credentials for accessing shared storages
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.access
+
+puts JSON.pretty_generate(response)
+
+
+
+# Change the password for accessing shared storages
+shared_storage = OneAndOne::SharedStorage.new()
+
+response = shared_storage.change_password(password: 'newpassword22')
+
+puts JSON.pretty_generate(response)

data/examples/usage_examples.rb

@@ -0,0 +1,6 @@
+# List all usages by time period
+usage = OneAndOne::Usage.new()
+
+response = usage.list(period: 'LAST_24H')
+
+puts JSON.pretty_generate(response)

data/examples/user_examples.rb

@@ -0,0 +1,113 @@
+# List all users on your account
+user = OneAndOne::User.new()
+
+response = user.list
+
+puts JSON.pretty_generate(response)
+
+
+
+# Create a new user
+user = OneAndOne::User.new()
+
+response = user.create(name: 'TestUser', email: 'test@example.com',
+  password: 'testpass')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Return a user's current specs
+user = OneAndOne::User.new()
+
+response = user.get(user_id: '<USER-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Modify a user account
+user = OneAndOne::User.new()
+
+response = user.modify(user_id: '<USER-ID>', description: 'New Description',
+  email: 'newemail@example.com')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Delete a user
+user = OneAndOne::User.new()
+
+response = user.delete(user_id: '<USER-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Return a user's API access credentials
+user = OneAndOne::User.new()
+
+response = user.api(user_id: '<USER-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Enable or disable a user's API access
+user = OneAndOne::User.new()
+
+response = user.enable_api(user_id: '<USER-ID>', active: true)
+
+puts JSON.pretty_generate(response)
+
+
+
+# Return a user's API key
+user = OneAndOne::User.new()
+
+response = user.api_key(user_id: '<USER-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Change a user's API key
+user = OneAndOne::User.new()
+
+response = user.change_key(user_id: '<USER-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# List the IP's from which a user can access the API
+user = OneAndOne::User.new()
+
+response = user.ips(user_id: '<USER-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Add IP's from which a user can access the API
+user = OneAndOne::User.new()
+
+ip1 = '1.2.3.4'
+
+ips = [ip1]
+
+response = user.add_ips(user_id: '<USER-ID>', ips: ips)
+
+puts JSON.pretty_generate(response)
+
+
+
+# Remove API access for an IP
+user = OneAndOne::User.new()
+
+ip1 = '1.2.3.4'
+
+response = user.remove_ip(user_id: '<USER-ID>', ip: ip1)
+
+puts JSON.pretty_generate(response)

data/examples/vpn_examples.rb

@@ -0,0 +1,56 @@
+# List all VPN's on your account
+vpn = OneAndOne::Vpn.new()
+
+response = vpn.list
+
+puts JSON.pretty_generate(response)
+
+
+
+# Create a new VPN
+vpn = OneAndOne::Vpn.new()
+
+response = vpn.create(name: 'Example VPN')
+
+puts JSON.pretty_generate(response)
+
+## Wait for VPN to deploy before performing other actions ## 
+puts "\nCreating VPN, please wait..."
+puts vpn.wait_for
+
+
+
+# Retrieve the current specs for a VPN
+vpn = OneAndOne::Vpn.new()
+
+response = vpn.get(vpn_id: '<VPN-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Modify a VPN
+vpn = OneAndOne::Vpn.new()
+
+response = vpn.modify(vpn_id: '<VPN-ID>', name: 'New Name')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Delete a VPN
+vpn = OneAndOne::Vpn.new()
+
+response = vpn.delete(vpn_id: '<VPN-ID>')
+
+puts JSON.pretty_generate(response)
+
+
+
+# Download a VPN's config file
+vpn = OneAndOne::Vpn.new()
+
+response = vpn.download_config(vpn_id: '<VPN-ID>')
+
+puts JSON.pretty_generate(response)
+

data/lib/1and1/datacenter.rb

@@ -0,0 +1,73 @@
+module OneAndOne
+
+
+  class Datacenter
+
+
+    def initialize(test: false)
+
+      # Check if hitting mock api or live api
+      if test
+        @connection = Excon.new($base_url, :mock => true)
+      else
+        @connection = Excon.new($base_url)
+      end
+
+    end
+
+
+    def list(page: nil, per_page: nil, sort: nil, q: nil, fields: nil)
+
+      # Build hash for query parameters
+      keyword_args = {
+        :page => page,
+        :per_page => per_page,
+        :sort => sort,
+        :q => q,
+        :fields => fields
+      }
+
+      # Clean out null query parameters
+      params = OneAndOne.clean_hash(keyword_args)
+
+      # Build URL
+      path = OneAndOne.build_url('/datacenters')
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header,
+        :query => params)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def get(datacenter_id: nil)
+
+      # Build URL
+      path = OneAndOne.build_url("/datacenters/#{datacenter_id}")
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+  end
+
+
+end

data/lib/1and1/dvd.rb

@@ -0,0 +1,73 @@
+module OneAndOne
+
+
+  class Dvd
+
+
+    def initialize(test: false)
+
+      # Check if hitting mock api or live api
+      if test
+        @connection = Excon.new($base_url, :mock => true)
+      else
+        @connection = Excon.new($base_url)
+      end
+
+    end
+
+
+    def list(page: nil, per_page: nil, sort: nil, q: nil, fields: nil)
+
+      # Build hash for query parameters
+      keyword_args = {
+        :page => page,
+        :per_page => per_page,
+        :sort => sort,
+        :q => q,
+        :fields => fields
+      }
+
+      # Clean out null query parameters
+      params = OneAndOne.clean_hash(keyword_args)
+
+      # Build URL
+      path = OneAndOne.build_url('/dvd_isos')
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header,
+        :query => params)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def get(dvd_id: nil)
+
+      # Build URL
+      path = OneAndOne.build_url("/dvd_isos/#{dvd_id}")
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+  end
+
+
+end

data/lib/1and1/firewall.rb

@@ -0,0 +1,427 @@
+module OneAndOne
+
+
+  class Firewall
+
+    
+    attr_accessor :id
+    attr_accessor :specs
+
+
+    def initialize(test: false)
+      @id = nil
+      @specs = nil
+
+      # Check if hitting mock api or live api
+      if test
+        @connection = Excon.new($base_url, :mock => true)
+      else
+        @connection = Excon.new($base_url)
+      end
+
+    end
+
+
+    def list(page: nil, per_page: nil, sort: nil, q: nil, fields: nil)
+
+      # Build hash for query parameters
+      keyword_args = {
+        :page => page,
+        :per_page => per_page,
+        :sort => sort,
+        :q => q,
+        :fields => fields
+      }
+
+      # Clean out null query parameters
+      params = OneAndOne.clean_hash(keyword_args)
+
+      # Build URL
+      path = OneAndOne.build_url('/firewall_policies')
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header,
+        :query => params)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def create(name: nil, description: nil, rules: nil)
+
+      # Build POST body
+      new_firewall = {
+        'name' => name,
+        'description' => description,
+        'rules' => rules,
+      }
+
+      # Clean out null keys in POST body
+      body = OneAndOne.clean_hash(new_firewall)
+
+      # Stringify the POST body
+      string_body = body.to_json
+
+      # Build URL
+      path = OneAndOne.build_url('/firewall_policies')
+
+      # Perform request
+      response = @connection.request(:method => :post,
+        :path => path,
+        :headers => $header,
+        :body => string_body)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      json = JSON.parse(response.body)
+
+      # Save new firewall ID to Firewall instance
+      @id = json['id']
+      @specs = json
+
+      # If all good, return JSON
+      json
+
+    end
+
+
+    def get(firewall_id: @id)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}")
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      json = JSON.parse(response.body)
+
+      # Reload specs attribute
+      @specs = json
+
+      # If all good, return JSON
+      json
+
+    end
+
+
+    def modify(firewall_id: @id, name: nil, description: nil)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build PUT body
+      new_firewall = {
+        'name' => name,
+        'description' => description
+      }
+
+      # Clean out null keys in PUT body
+      body = OneAndOne.clean_hash(new_firewall)
+
+      # Stringify the PUT body
+      string_body = body.to_json
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}")
+
+      # Perform request
+      response = @connection.request(:method => :put,
+        :path => path,
+        :headers => $header,
+        :body => string_body)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def delete(firewall_id: @id)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}")
+
+      # Perform request
+      response = @connection.request(:method => :delete,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def ips(firewall_id: @id)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}/server_ips")
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def ip(firewall_id: @id, ip_id: nil)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}/server_ips/#{ip_id}")
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def add_ips(firewall_id: @id, ips: nil)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build POST body
+      new_ips = {
+        'server_ips' => ips
+      }
+
+      # Clean out null keys in POST body
+      body = OneAndOne.clean_hash(new_ips)
+
+      # Stringify the POST body
+      string_body = body.to_json
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}/server_ips")
+
+      # Perform request
+      response = @connection.request(:method => :post,
+        :path => path,
+        :headers => $header,
+        :body => string_body)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def remove_ip(firewall_id: @id, ip_id: nil)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}/server_ips/#{ip_id}")
+
+      # Perform request
+      response = @connection.request(:method => :delete,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def rules(firewall_id: @id)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}/rules")
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def rule(firewall_id: @id, rule_id: nil)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}/rules/#{rule_id}")
+
+      # Perform request
+      response = @connection.request(:method => :get,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def add_rules(firewall_id: @id, rules: nil)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build POST body
+      new_rules = {
+        'rules' => rules
+      }
+
+      # Clean out null keys in POST body
+      body = OneAndOne.clean_hash(new_rules)
+
+      # Stringify the POST body
+      string_body = body.to_json
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}/rules")
+
+      # Perform request
+      response = @connection.request(:method => :post,
+        :path => path,
+        :headers => $header,
+        :body => string_body)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def remove_rule(firewall_id: @id, rule_id: nil)
+
+      # If user passed in firewall ID, reassign
+      @id = firewall_id
+
+      # Build URL
+      path = OneAndOne.build_url("/firewall_policies/#{@id}/rules/#{rule_id}")
+
+      # Perform request
+      response = @connection.request(:method => :delete,
+        :path => path,
+        :headers => $header)
+
+      # Check response status
+      OneAndOne.check_response(response.body, response.status)
+
+      #JSON-ify the response string
+      JSON.parse(response.body)
+
+    end
+
+
+    def reload
+
+      # This reload fx is just a wrapper for the get fx
+      get
+
+    end
+
+
+    def wait_for(timeout: 25, interval: 1)
+
+      # Capture start time
+      start = Time.now
+
+      # Poll firewall and check initial state
+      initial_response = get
+      firewall_state = initial_response['state']
+
+      # Keep polling the firewall's state until good
+      until $good_states.include? firewall_state
+
+        # Wait 1 second before polling again
+        sleep interval
+
+        # Check firewall state again
+        current_response = get
+        firewall_state = current_response['state']
+
+        # Calculate current duration and check for timeout
+        duration = (Time.now - start) / 60
+        if duration > timeout
+          puts "The operation timed out after #{timeout} minutes.\n"
+          return
+        end
+
+      end
+
+      # Return Duration
+      {:duration => duration}
+
+    end
+
+
+  end
+
+
+end