/usr/lib/ruby/vendor_ruby/AWS/ELB/load_balancers.rb is in ruby-amazon-ec2 0.9.17-2build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 | module AWS
module ELB
class Base < AWS::Base
# This API creates a new LoadBalancer. Once the call has completed
# successfully, a new LoadBalancer will be created, but it will not be
# usable until at least one instance has been registered. When the
# LoadBalancer creation is completed, you can check whether it is usable
# by using the DescribeInstanceHealth API. The LoadBalancer is usable as
# soon as any registered instance is InService.
#
# @option options [String] :load_balancer_name (nil) the name of the load balancer
# @option options [Array] :availability_zones (nil)
# @option options [Array] :listeners (nil) An Array of Hashes (:protocol, :load_balancer_port, :instance_port)
# @option options [Array] :availability_zones (nil) An Array of Strings
#
def create_load_balancer( options = {} )
raise ArgumentError, "No :availability_zones provided" if options[:availability_zones].nil? || options[:availability_zones].empty?
raise ArgumentError, "No :listeners provided" if options[:listeners].nil? || options[:listeners].empty?
raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
params = {}
params.merge!(pathlist('AvailabilityZones.member', [options[:availability_zones]].flatten))
params.merge!(pathhashlist('Listeners.member', [options[:listeners]].flatten, {
:protocol => 'Protocol',
:load_balancer_port => 'LoadBalancerPort',
:instance_port => 'InstancePort'
}))
params['LoadBalancerName'] = options[:load_balancer_name]
return response_generator(:action => "CreateLoadBalancer", :params => params)
end
# This API deletes the specified LoadBalancer. On deletion, all of the
# configured properties of the LoadBalancer will be deleted. If you
# attempt to recreate the LoadBalancer, you need to reconfigure all the
# settings. The DNS name associated with a deleted LoadBalancer is no
# longer be usable. Once deleted, the name and associated DNS record of
# the LoadBalancer no longer exist and traffic sent to any of its IP
# addresses will no longer be delivered to your instances. You will not
# get the same DNS name even if you create a new LoadBalancer with same
# LoadBalancerName.
#
# @option options [String] :load_balancer_name the name of the load balancer
#
def delete_load_balancer( options = {} )
raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
params = { 'LoadBalancerName' => options[:load_balancer_name] }
return response_generator(:action => "DeleteLoadBalancer", :params => params)
end
# This API returns detailed configuration information for the specified
# LoadBalancers, or if no LoadBalancers are specified, then the API
# returns configuration information for all LoadBalancers created by the
# caller. For more information, please see LoadBalancer.
#
# You must have created the specified input LoadBalancers in order to
# retrieve this information. In other words, in order to successfully call
# this API, you must provide the same account credentials as those that
# were used to create the LoadBalancer.
#
# @option options [Array<String>] :load_balancer_names ([]) An Array of names of load balancers to describe.
#
def describe_load_balancers( options = {} )
options = { :load_balancer_names => [] }.merge(options)
params = pathlist("LoadBalancerName.member", options[:load_balancer_names])
return response_generator(:action => "DescribeLoadBalancers", :params => params)
end
# This API adds new instances to the LoadBalancer.
#
# Once the instance is registered, it starts receiving traffic and
# requests from the LoadBalancer. Any instance that is not in any of the
# Availability Zones registered for the LoadBalancer will be moved to
# the OutOfService state. It will move to the InService state when the
# Availability Zone is added to the LoadBalancer.
#
# You must have been the one who created the LoadBalancer. In other
# words, in order to successfully call this API, you must provide the
# same account credentials as those that were used to create the
# LoadBalancer.
#
# NOTE: Completion of this API does not guarantee that operation has
# completed. Rather, it means that the request has been registered and
# the changes will happen shortly.
#
# @option options [Array<String>] :instances An Array of instance names to add to the load balancer.
# @option options [String] :load_balancer_name The name of the load balancer.
#
def register_instances_with_load_balancer( options = {} )
raise ArgumentError, "No :instances provided" if options[:instances].nil? || options[:instances].empty?
raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
params = {}
params.merge!(pathhashlist('Instances.member', options[:instances].flatten.collect{|e| {:instance_id => e}}, {:instance_id => 'InstanceId'}))
params['LoadBalancerName'] = options[:load_balancer_name]
return response_generator(:action => "RegisterInstancesWithLoadBalancer", :params => params)
end
# This API deregisters instances from the LoadBalancer. Trying to
# deregister an instance that is not registered with the LoadBalancer
# does nothing.
#
# In order to successfully call this API, you must provide the same
# account credentials as those that were used to create the
# LoadBalancer.
#
# Once the instance is deregistered, it will stop receiving traffic from
# the LoadBalancer.
#
# @option options [Array<String>] :instances An Array of instance names to remove from the load balancer.
# @option options [String] :load_balancer_name The name of the load balancer.
#
def deregister_instances_from_load_balancer( options = {} )
raise ArgumentError, "No :instances provided" if options[:instances].nil? || options[:instances].empty?
raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
params = {}
params.merge!(pathhashlist('Instances.member', options[:instances].flatten.collect{|e| {:instance_id => e}}, {:instance_id => 'InstanceId'}))
params['LoadBalancerName'] = options[:load_balancer_name]
return response_generator(:action => "DeregisterInstancesFromLoadBalancer", :params => params)
end
# This API enables you to define an application healthcheck for the
# instances.
#
# Note: Completion of this API does not guarantee that operation has completed. Rather, it means that the request has been registered and the changes will happen shortly.
#
# @option options [String] :load_balancer_name The name of the load balancer.
# @option options [Hash] :health_check A Hash with the key values provided as String or FixNum values (:timeout, :interval, :unhealthy_threshold, :healthy_threshold)
#
def configure_health_check( options = {} )
raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
raise ArgumentError, "No :health_check Hash provided" if options[:health_check].nil? || options[:health_check].empty?
params = {}
params['LoadBalancerName'] = options[:load_balancer_name]
params['HealthCheck.Target'] = options[:health_check][:target] unless options[:health_check][:target].nil?
params['HealthCheck.Timeout'] = options[:health_check][:timeout].to_s unless options[:health_check][:timeout].nil?
params['HealthCheck.Interval'] = options[:health_check][:interval].to_s unless options[:health_check][:interval].nil?
params['HealthCheck.UnhealthyThreshold'] = options[:health_check][:unhealthy_threshold].to_s unless options[:health_check][:unhealthy_threshold].nil?
params['HealthCheck.HealthyThreshold'] = options[:health_check][:healthy_threshold].to_s unless options[:health_check][:healthy_threshold].nil?
return response_generator(:action => "ConfigureHealthCheck", :params => params)
end
# This API returns the current state of the instances of the specified LoadBalancer. If no instances are specified,
# the state of all the instances for the LoadBalancer is returned.
#
# You must have been the one who created in the LoadBalancer. In other words, in order to successfully call this API,
# you must provide the same account credentials as those that were used to create the LoadBalancer.
#
# @option options [Array<String>] :instances List of instances IDs whose state is being queried.
# @option options [String] :load_balancer_name The name of the load balancer
#
def describe_instance_health( options = {} )
raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
params = {}
params['LoadBalancerName'] = options[:load_balancer_name]
params.merge!(pathlist('Instances.member', [options[:instances]].flatten)) if options.has_key?(:instances)
return response_generator(:action => "DescribeInstanceHealth", :params => params)
end
# This API removes the specified EC2 Availability Zones from the set of configured Availability Zones for the
# LoadBalancer. Once an Availability Zone is removed, all the instances registered with the LoadBalancer that
# are in the removed Availability Zone go into the OutOfService state. Upon Availability Zone removal, the
# LoadBalancer attempts to equally balance the traffic among its remaining usable Availability Zones. Trying to
# remove an Availability Zone that was not associated with the LoadBalancer does nothing.
#
# There must be at least one Availability Zone registered with a LoadBalancer at all times. You cannot remove
# all the Availability Zones from a LoadBalancer.
#
# In order for this call to be successful, you must have created the LoadBalancer. In other words, in order to
# successfully call this API, you must provide the same account credentials as those that were used to create
# the LoadBalancer.
#
# @option options [Array<String>] :availability_zones List of Availability Zones to be removed from the LoadBalancer.
# @option options [String] :load_balancer_name The name of the load balancer
#
def disable_availability_zones_for_load_balancer( options = {} )
raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
raise ArgumentError, "No :availability_zones provided" if options[:availability_zones].nil? || options[:availability_zones].empty?
params = {}
params['LoadBalancerName'] = options[:load_balancer_name]
params.merge!(pathlist('AvailabilityZones.member', [options[:availability_zones]].flatten))
return response_generator(:action => "DisableAvailabilityZonesForLoadBalancer", :params => params)
end
# This API is used to add one or more EC2 Availability Zones to the LoadBalancer.
#
# @option options [Array<String>] :availability_zones List of Availability Zones to be added to the LoadBalancer.
# @option options [String] :load_balancer_name The name of the load balancer
#
def enable_availability_zones_for_load_balancer( options = {} )
raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
raise ArgumentError, "No :availability_zones provided" if options[:availability_zones].nil? || options[:availability_zones].empty?
params = {}
params['LoadBalancerName'] = options[:load_balancer_name]
params.merge!(pathlist('AvailabilityZones.member', [options[:availability_zones]].flatten))
return response_generator(:action => "EnableAvailabilityZonesForLoadBalancer", :params => params)
end
end
end
end
|