Class: VirtualServerService

Inherits:
Object
  • Object
show all
Defined in:
lib/api/virtualserver/VirtualServerService.rb

Overview

VirtualServerService

This class provides a facade for SOAP method calls to the ZXTM Virtual Server web service.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(endpoint = nil, username = nil, password = nil) ⇒ VirtualServerService

Returns a new instance of VirtualServerService.



11
12
13
14
15
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 11

def initialize(endpoint=nil, username=nil, password=nil)
  @driver = VirtualServerPort.new(endpoint)
  @driver.options["protocol.http.ssl_config.verify_mode"] = OpenSSL::SSL::VERIFY_NONE
  @driver.options["protocol.http.basic_auth"] << [endpoint, username, password]
end

Instance Attribute Details

#driver ⇒ Object

Returns the value of attribute driver.



9
10
11
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 9

def driver
  @driver
end

Instance Method Details

#add_request_rule(vs_name, rule) ⇒ Object

Adds a request rule (and enables it)

Args

name (String)          - Virtual server's name
rule (String)          - Rule name

Examples

add_request_rule("test", "some-rule")



107
108
109
110
111
112
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 107

def add_request_rule(vs_name, rule)
  vsr = VirtualServerRule.new
  vsr.name = rule
  vsr.enabled = true
  @driver.addRules([vs_name],[[vsr]])
end

#add_response_rule(vs_name, rule) ⇒ Object

Adds a response rule (and enables it)

Args

name (String)          - Virtual server's name
rule (String)          - Rule name

Examples

add_request_rule("test", "some-rule")



136
137
138
139
140
141
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 136

def add_response_rule(vs_name, rule)
  vsr = VirtualServerRule.new
  vsr.name = rule
  vsr.enabled = true
  @driver.addResponseRules([vs_name], [[vsr]])
end

#create(name = nil, vs_info = {}) ⇒ Object

Creates new virtual server

Args

name (String)          - Virtual server's name
vs_info (Hash)         - Virtual server's properties

Examples

create("web")          - Creates new virtual server called "web" with default properties
create("web", {:port => "80", :protocol => "http", :default_pool => "web-pool"})



61
62
63
64
65
66
67
68
69
70
71
72
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 61

def create(name=nil, vs_info={})
  default_port = "80"
  default_protocol = "http"
  default_pool = "discard"

  vs_basic_info = VirtualServerBasicInfo.new
  vs_basic_info.port = vs_info[:port] || default_port
  vs_basic_info.protocol = vs_info[:protocol] || default_protocol
  vs_basic_info.default_pool = vs_info[:default_pool] || default_pool

  @driver.addVirtualServer([name], [vs_basic_info])
end

#disable(vs_name = nil) ⇒ Object

Disables a virtual server

Args

name (String)          - Virtual server's name to disable

Examples

disable("web")         - Disables a virtual server called "web"



94
95
96
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 94

def disable(vs_name=nil)
  @driver.setEnabled([vs_name], [false])
end

#enable(vs_name = nil) ⇒ Object

Enables a virtual server

Args

name (String)          - Virtual server's name to enable

Examples

enable("web")          - Enables a virtual server called "web"



82
83
84
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 82

def enable(vs_name=nil)
  @driver.setEnabled([vs_name], [true])
end

#list(status = nil) ⇒ Object

Returns a list of virtual servers

Args

status            - Symbol (possible values: :all, :enabled, :disabled)

Examples

names(:all)       - Returns all virtual server names (default)
names(:enabled)   - Returns enabled virtual server names
names(:disabled)  - Returns disabled virtual server names



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 27

def list(status=nil)
  result = []
  valid_status = [:all, :enabled, :disabled]
  status = :all if status.nil? or !valid_status.include?(status)

  vs_names = @driver.getVirtualServerNames
  return vs_names if status == :all

  enabled_vs = @driver.getEnabled(vs_names)

  case status
  when :enabled
    vs_names.length.times do |i|
      result << vs_names[i] if enabled_vs[i]
    end      
  when :disabled
    vs_names.length.times do |i|
      result << vs_names[i] unless enabled_vs[i]
    end
  end

  return result
end

#remove_request_rule(vs_name, rule) ⇒ Object

Removes a request rule

Args

name (String)          - Virtual server's name
rule (String)          - Rule name

Examples

remove_request_rule("test", "some-rule")



123
124
125
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 123

def remove_request_rule(vs_name, rule)
  @driver.removeRules([vs_name], [[rule]])
end

#remove_response_rule(vs_name, rule) ⇒ Object

Removes a response rule

Args

name (String)          - Virtual server's name
rule (String)          - Rule name

Examples

remove_response_rule("test", "some-rule")



152
153
154
 
# File 'lib/api/virtualserver/VirtualServerService.rb', line 152

def remove_response_rule(vs_name, rule)
  @driver.removeResponseRules([vs_name], [[rule]])
end