class Fog::Rackspace::LoadBalancers::Real

Public Class Methods

new(options={}) click to toggle source
# File lib/fog/rackspace/load_balancers.rb, line 105
def initialize(options={})
  @rackspace_api_key = options[:rackspace_api_key]
  @rackspace_username = options[:rackspace_username]
  @rackspace_auth_url = options[:rackspace_auth_url]
  @rackspace_must_reauthenticate = false
  @connection_options     = options[:connection_options] || {}

  setup_custom_endpoint(options)

  authenticate

  deprecation_warnings(options)

  @persistent = options[:persistent] || false
  @connection = Fog::Core::Connection.new(endpoint_uri.to_s, @persistent, @connection_options)
end

Public Instance Methods

authenticate(options={}) click to toggle source
Calls superclass method Fog::Rackspace::Service#authenticate
# File lib/fog/rackspace/load_balancers.rb, line 134
def authenticate(options={})
  super({
    :rackspace_api_key => @rackspace_api_key,
    :rackspace_username => @rackspace_username,
    :rackspace_auth_url => @rackspace_auth_url,
    :connection_options => @connection_options
  })
end
create_access_rule(load_balancer_id, address, type) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/create_access_rule.rb, line 5
def create_access_rule(load_balancer_id, address, type)
  #TODO - This can actually support adding multiple access rules.
  data = {
    'accessList' => [
      {
        'address' => address,
        'type' => type
      }
  ]}
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :method   => 'POST',
    :path     => "loadbalancers/#{load_balancer_id}/accesslist"
  )
end
create_load_balancer(name, protocol, port, virtual_ips, nodes, options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/create_load_balancer.rb, line 5
def create_load_balancer(name, protocol, port, virtual_ips, nodes, options = {})
  data = {
    'loadBalancer' => {
      'name' => name,
      'port' => port,
      'protocol' => protocol,
      'virtualIps' => virtual_ips,
    }
  }

  data['loadBalancer']['nodes'] = nodes if nodes && !nodes.empty?
  data['loadBalancer']['algorithm'] = options[:algorithm] if options.key? :algorithm
  data['loadBalancer']['timeout'] = options[:timeout] if options.key? :timeout

  request(
    :body     => Fog::JSON.encode(data),
    :expects  => 202,
    :method   => 'POST',
    :path     => 'loadbalancers.json'
  )
end
create_node(load_balancer_id, address, port, condition, options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/create_node.rb, line 5
def create_node(load_balancer_id, address, port, condition, options = {})
  data = {
    'nodes' => [
      {
        'address' => address,
        'port' => port,
        'condition' => condition
      }
  ]}
  if options.key?(:weight)
    data['nodes'][0]['weight'] = options[:weight]
  end
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :method   => 'POST',
    :path     => "loadbalancers/#{load_balancer_id}/nodes.json"
  )
end
create_virtual_ip(load_balancer_id, type) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/create_virtual_ip.rb, line 5
def create_virtual_ip(load_balancer_id, type)
  data = {
    'type' => type,
    'ipVersion' => 'IPV6'
  }
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :method   => 'POST',
    :path     => "loadbalancers/#{load_balancer_id}/virtualips.json"
  )
end
delete_access_rule(load_balancer_id, access_rule_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/delete_access_rule.rb, line 5
def delete_access_rule(load_balancer_id, access_rule_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/accesslist/#{access_rule_id}",
    :method => 'DELETE'
  )
end
delete_all_access_rules(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/delete_all_access_rules.rb, line 5
def delete_all_access_rules(load_balancer_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/accesslist",
    :method => 'DELETE'
  )
end
delete_load_balancer(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/delete_load_balancer.rb, line 5
def delete_load_balancer(load_balancer_id)
  request(
    :expects => 202,
    :path => "loadbalancers/#{load_balancer_id}.json",
    :method => 'DELETE'
  )
end
delete_node(load_balancer_id, node_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/delete_node.rb, line 5
def delete_node(load_balancer_id, node_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/nodes/#{node_id}",
    :method => 'DELETE'
  )
end
delete_nodes(load_balancer_id, *node_ids) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/delete_nodes.rb, line 5
def delete_nodes(load_balancer_id, *node_ids)
  query_string = node_ids.map { |node_id| "id=#{node_id}" }.join('&')
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/nodes?#{query_string}",
    :method => 'DELETE'
  )
end
delete_virtual_ip(load_balancer_id, virtual_ip_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/delete_virtual_ip.rb, line 5
def delete_virtual_ip(load_balancer_id, virtual_ip_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/virtualips/#{virtual_ip_id}",
    :method => 'DELETE'
  )
end
endpoint_uri(service_endpoint_url=nil) click to toggle source
Calls superclass method Fog::Rackspace::Service#endpoint_uri
# File lib/fog/rackspace/load_balancers.rb, line 151
def endpoint_uri(service_endpoint_url=nil)
  @uri = super(@rackspace_endpoint || service_endpoint_url, :rackspace_load_balancers_url)
end
get_connection_logging(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_connection_logging.rb, line 5
def get_connection_logging(load_balancer_id)
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}/connectionlogging",
    :method => 'GET'
  )
 end
get_connection_throttling(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_connection_throttling.rb, line 5
def get_connection_throttling(load_balancer_id)
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}/connectionthrottle",
    :method => 'GET'
  )
 end
get_content_caching(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_content_caching.rb, line 5
def get_content_caching(load_balancer_id)
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}/contentcaching",
    :method => 'GET'
  )
 end
get_error_page(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_error_page.rb, line 5
def get_error_page(load_balancer_id)
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}/errorpage",
    :method => 'GET'
  )
 end
get_load_balancer(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_load_balancer.rb, line 5
def get_load_balancer(load_balancer_id)
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}.json",
    :method => 'GET'
  )
 end
get_load_balancer_usage(load_balancer_id, options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_load_balancer_usage.rb, line 5
def get_load_balancer_usage(load_balancer_id, options = {})
  #TODO - Didn't implement usage/current.  Not sure if it is needed
  if options.key? :start_time and options.key? :end_time
    query = "?startTime=#{options[:start_time]}&endTime=#{options[:end_time]}"
  else
    query = ''
  end
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}/usage#{query}",
    :method => 'GET'
  )
 end
get_monitor(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_monitor.rb, line 5
def get_monitor(load_balancer_id)
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}/healthmonitor",
    :method => 'GET'
  )
 end
get_node(load_balancer_id, node_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_node.rb, line 5
def get_node(load_balancer_id, node_id)
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}/nodes/#{node_id}.json",
    :method => 'GET'
  )
 end
get_session_persistence(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_session_persistence.rb, line 5
def get_session_persistence(load_balancer_id)
  request(
    :expects => 200,
    :path => "loadbalancers/#{load_balancer_id}/sessionpersistence",
    :method => 'GET'
  )
 end
get_ssl_termination(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_ssl_termination.rb, line 5
def get_ssl_termination(load_balancer_id)
  request(
    :expects => [200],
    :path => "loadbalancers/#{load_balancer_id}/ssltermination",
    :method => 'GET'
  )
 end
get_stats(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_stats.rb, line 5
def get_stats(load_balancer_id)
  request(
      :expects => 200,
      :path => "loadbalancers/#{load_balancer_id}/stats",
      :method => 'GET'
  )
end
get_usage(options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/get_usage.rb, line 5
def get_usage(options = {})
  if options.key? :start_time and options.key? :end_time
    query = "?startTime=#{options[:start_time]}&endTime=#{options[:end_time]}"
  else
    query = ''
  end
  request(
    :expects => 200,
    :path => "loadbalancers/usage#{query}",
    :method => 'GET'
  )
 end
list_access_rules(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/list_access_rules.rb, line 5
def list_access_rules(load_balancer_id)
  request(
    :expects  => 200,
    :method   => 'GET',
    :path     => "loadbalancers/#{load_balancer_id}/accesslist"
  )
end
list_algorithms() click to toggle source
# File lib/fog/rackspace/requests/load_balancers/list_algorithms.rb, line 5
def list_algorithms
  request(
    :expects  => 200,
    :method   => 'GET',
    :path     => 'loadbalancers/algorithms'
  )
end
list_load_balancers(options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/list_load_balancers.rb, line 5
def list_load_balancers(options = {})
  if options.key? :node_address
    query_string = "?nodeaddress=#{options[:node_address]}"
  else
    query_string = ''
  end

  request(
    :expects  => 200,
    :method   => 'GET',
    :path     => "loadbalancers.json?#{query_string}"
  )
end
list_nodes(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/list_nodes.rb, line 5
def list_nodes(load_balancer_id)
  request(
    :expects  => 200,
    :method   => 'GET',
    :path     => "loadbalancers/#{load_balancer_id}/nodes.json"
  )
end
list_protocols() click to toggle source
# File lib/fog/rackspace/requests/load_balancers/list_protocols.rb, line 5
def list_protocols
  request(
    :expects  => 200,
    :method   => 'GET',
    :path     => 'loadbalancers/protocols'
  )
end
list_virtual_ips(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/list_virtual_ips.rb, line 5
def list_virtual_ips(load_balancer_id)
  request(
    :expects  => 200,
    :method   => 'GET',
    :path     => "loadbalancers/#{load_balancer_id}/virtualips.json"
  )
end
region() click to toggle source
# File lib/fog/rackspace/load_balancers.rb, line 147
def region
  @rackspace_region
end
remove_connection_throttling(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/remove_connection_throttling.rb, line 5
def remove_connection_throttling(load_balancer_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/connectionthrottle",
    :method => 'DELETE'
  )
 end
remove_error_page(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/remove_error_page.rb, line 5
def remove_error_page(load_balancer_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/errorpage",
    :method => 'DELETE'
  )
 end
remove_monitor(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/remove_monitor.rb, line 5
def remove_monitor(load_balancer_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/healthmonitor",
    :method => 'DELETE'
  )
 end
remove_session_persistence(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/remove_session_persistence.rb, line 5
def remove_session_persistence(load_balancer_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/sessionpersistence",
    :method => 'DELETE'
  )
 end
remove_ssl_termination(load_balancer_id) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/remove_ssl_termination.rb, line 5
def remove_ssl_termination(load_balancer_id)
  request(
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/ssltermination",
    :method => 'DELETE'
  )
 end
request(params, parse_json = true) click to toggle source
Calls superclass method Fog::Rackspace::Service#request
# File lib/fog/rackspace/load_balancers.rb, line 122
def request(params, parse_json = true)
  super
rescue Excon::Errors::NotFound => error
  raise NotFound.slurp(error, self)
rescue Excon::Errors::BadRequest => error
  raise BadRequest.slurp(error, self)
rescue Excon::Errors::InternalServerError => error
  raise InternalServerError.slurp(error, self)
rescue Excon::Errors::HTTPStatusError => error
  raise ServiceError.slurp(error, self)
end
service_name() click to toggle source
# File lib/fog/rackspace/load_balancers.rb, line 143
def service_name
  :cloudLoadBalancers
end
set_connection_logging(load_balancer_id, value) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/set_connection_logging.rb, line 5
def set_connection_logging(load_balancer_id, value)
  data = {
    'connectionLogging' => {
      'enabled' => value.to_s
    }
  }
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :path     => "loadbalancers/#{load_balancer_id}/connectionlogging",
    :method   => 'PUT'
  )
 end
set_connection_throttling(load_balancer_id, max_connections, min_connections, max_connection_rate, rate_interval) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/set_connection_throttling.rb, line 5
def set_connection_throttling(load_balancer_id, max_connections, min_connections, max_connection_rate, rate_interval)
  data = {
    'maxConnections' => max_connections,
    'minConnections' => min_connections,
    'maxConnectionRate' => max_connection_rate,
    'rateInterval' => rate_interval
  }
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :path     => "loadbalancers/#{load_balancer_id}/connectionthrottle",
    :method   => 'PUT'
  )
 end
set_content_caching(load_balancer_id, value) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/set_content_caching.rb, line 5
def set_content_caching(load_balancer_id, value)
  data = {
    'contentCaching' => {
      'enabled' => value.to_s
    }
  }
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :path     => "loadbalancers/#{load_balancer_id}/contentcaching",
    :method   => 'PUT'
  )
 end
set_error_page(load_balancer_id, content) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/set_error_page.rb, line 5
def set_error_page(load_balancer_id, content)
  data = {
    'errorpage' => {
      'content' => content
    }
  }
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :path     => "loadbalancers/#{load_balancer_id}/errorpage",
    :method   => 'PUT'
  )
 end
set_monitor(load_balancer_id, type, delay, timeout, attempsBeforeDeactivation, options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/set_monitor.rb, line 5
def set_monitor(load_balancer_id, type, delay, timeout, attempsBeforeDeactivation, options = {})
  data = {
    'type' => type,
    'delay' => delay,
    'timeout' => timeout,
    'attemptsBeforeDeactivation' => attempsBeforeDeactivation
  }
  if options.key? :path
    data['path'] = options[:path]
  end
  if options.key? :body_regex
    data['bodyRegex'] = options[:body_regex]
  end
  if options.key? :status_regex
    data['statusRegex'] = options[:status_regex]
  end
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :path     => "loadbalancers/#{load_balancer_id}/healthmonitor",
    :method   => 'PUT'
  )
 end
set_session_persistence(load_balancer_id, persistence_type) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/set_session_persistence.rb, line 5
def set_session_persistence(load_balancer_id, persistence_type)
  data = {
    'sessionPersistence' => {
      'persistenceType' => persistence_type
    }
  }
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :path     => "loadbalancers/#{load_balancer_id}/sessionpersistence",
    :method   => 'PUT'
  )
 end
set_ssl_termination(load_balancer_id, securePort, privatekey, certificate, options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/set_ssl_termination.rb, line 5
def set_ssl_termination(load_balancer_id, securePort, privatekey, certificate, options = {})
  data = {
    :securePort => securePort,
    :privatekey => privatekey,
    :certificate => certificate
  }

  if options.key? :intermediate_certificate
    data['intermediateCertificate'] = options[:intermediate_certificate]
  end
  if options.key? :enabled
    data['enabled'] = options[:enabled]
  end
  if options.key? :secure_traffic_only
    data['secureTrafficOnly'] = options[:secure_traffic_only]
  end
  request(
    :body     => Fog::JSON.encode(data),
    :expects => [200, 202],
    :path => "loadbalancers/#{load_balancer_id}/ssltermination",
    :method => 'PUT'
  )
 end
update_load_balancer(load_balancer_id, options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/update_load_balancer.rb, line 5
def update_load_balancer(load_balancer_id, options = {})
  data = {
    'loadBalancer' => {
      'name' => options[:name],
      'port' => options[:port],
      'protocol' => options[:protocol],
      'algorithm' => options[:algorithm],
      'timeout' => options[:timeout]
    }
  }
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => 202,
    :method   => 'PUT',
    :path     => "loadbalancers/#{load_balancer_id}.json"
  )
end
update_node(load_balancer_id, node_id, options = {}) click to toggle source
# File lib/fog/rackspace/requests/load_balancers/update_node.rb, line 5
def update_node(load_balancer_id, node_id, options = {})
  data = {
    'node' => {}
  }
  if options.key? :weight
    data['node']['weight'] = options[:weight]
  end
  if options.key? :condition
    data['node']['condition'] = options[:condition]
  end
  #TODO - Do anything if no valid options are passed in?
  request(
    :body     => Fog::JSON.encode(data),
    :expects  => [200, 202],
    :method   => 'PUT',
    :path     => "loadbalancers/#{load_balancer_id}/nodes/#{node_id}.json"
  )
end

Private Instance Methods

append_tenant_v1(credentials) click to toggle source
# File lib/fog/rackspace/load_balancers.rb, line 194
def append_tenant_v1(credentials)
  account_id = credentials['X-Server-Management-Url'].match(/.*\/([\d]+)$/)[1]

  endpoint = @rackspace_endpoint || credentials['X-Server-Management-Url'] || DFW_ENDPOINT
  @uri = URI.parse(endpoint)
  @uri.path = "#{@uri.path}/#{account_id}"
end
authenticate_v1(options) click to toggle source
# File lib/fog/rackspace/load_balancers.rb, line 202
def authenticate_v1(options)
  credentials = Fog::Rackspace.authenticate(options, @connection_options)
  append_tenant_v1 credentials
  @auth_token = credentials['X-Auth-Token']
end
deprecation_warnings(options) click to toggle source
# File lib/fog/rackspace/load_balancers.rb, line 181
def deprecation_warnings(options)
  Fog::Logger.deprecation("The :rackspace_lb_endpoint option is deprecated. Please use :rackspace_load_balancers_url for custom endpoints") if options[:rackspace_lb_endpoint]

  if [DFW_ENDPOINT, ORD_ENDPOINT, LON_ENDPOINT].include?(@rackspace_endpoint) && v2_authentication?
    regions = @identity_service.service_catalog.display_service_regions(service_name)
    Fog::Logger.deprecation("Please specify region using :rackspace_region rather than :rackspace_endpoint. Valid regions for :rackspace_region are #{regions}.")
  end

  unless options[:rackspace_region]
    Fog::Logger.deprecation("Default region support will be removed in an upcoming release. Please switch to manually setting your endpoint. This requires setting the :rackspace_region option")
  end
end
setup_custom_endpoint(options) click to toggle source
# File lib/fog/rackspace/load_balancers.rb, line 157
def setup_custom_endpoint(options)
  @rackspace_endpoint = Fog::Rackspace.normalize_url(options[:rackspace_load_balancers_url] || options[:rackspace_lb_endpoint])

  if v2_authentication?
    case @rackspace_endpoint
    when DFW_ENDPOINT
      @rackspace_endpoint = nil
      @rackspace_region = :dfw
    when ORD_ENDPOINT
      @rackspace_endpoint = nil
      @rackspace_region = :ord
    when LON_ENDPOINT
      @rackspace_endpoint = nil
      @rackspace_region = :lon
    else
      # we are actually using a custom endpoint
      @rackspace_region = options[:rackspace_region] || :dfw
    end
  else
    #if we are using auth1 and the endpoint is not set, default to DFW_ENDPOINT for historical reasons
     @rackspace_endpoint ||= DFW_ENDPOINT
  end
end