Class Fog::AWS::ELB::Real
In: lib/fog/aws/requests/elb/create_load_balancer.rb
lib/fog/aws/requests/elb/delete_load_balancer_policy.rb
lib/fog/aws/requests/elb/create_load_balancer_listeners.rb
lib/fog/aws/requests/elb/delete_load_balancer.rb
lib/fog/aws/requests/elb/describe_instance_health.rb
lib/fog/aws/requests/elb/set_load_balancer_policies_of_listener.rb
lib/fog/aws/requests/elb/deregister_instances_from_load_balancer.rb
lib/fog/aws/requests/elb/create_lb_cookie_stickiness_policy.rb
lib/fog/aws/requests/elb/enable_availability_zones_for_load_balancer.rb
lib/fog/aws/requests/elb/create_app_cookie_stickiness_policy.rb
lib/fog/aws/requests/elb/disable_availability_zones_for_load_balancer.rb
lib/fog/aws/requests/elb/delete_load_balancer_listeners.rb
lib/fog/aws/requests/elb/register_instances_with_load_balancer.rb
lib/fog/aws/requests/elb/describe_load_balancers.rb
lib/fog/aws/requests/elb/configure_health_check.rb
lib/fog/aws/elb.rb
Parent: Object

Methods

Public Class methods

Initialize connection to ELB

Notes

options parameter must include values for :aws_access_key_id and :aws_secret_access_key in order to create a connection

Examples

  elb = ELB.new(
   :aws_access_key_id => your_aws_access_key_id,
   :aws_secret_access_key => your_aws_secret_access_key
  )

Parameters

  • options<~Hash> - config arguments for connection. Defaults to {}.
    • region<~String> - optional region to use, in [‘eu-west-1’, ‘us-east-1’, ‘us-west-1’, ‘ap-northeast-1’, ‘ap-southeast-1’]

Returns

  • ELB object with connection to AWS.

Public Instance methods

Enables the client to define an application healthcheck for the instances. See docs.amazonwebservices.com/ElasticLoadBalancing/latest/APIReference/index.html?API_ConfigureHealthCheck.html

Parameters

  • lb_name<~String> - Name of the ELB
  • health_check<~Hash> - A hash of parameters describing the health check
    • ‘HealthyThreshold’<~Integer> - Specifies the number of consecutive health probe successes required before moving the instance to the Healthy state.
    • ‘Interval’<~Integer> - Specifies the approximate interval, in seconds, between health checks of an individual instance.
    • ‘Target’<~String> - Specifies the instance being checked. The protocol is either TCP or HTTP. The range of valid ports is one (1) through 65535.
    • ‘Timeout’<~Integer> - Specifies the amount of time, in seconds,

    during which no response means a failed health probe.

    • ‘UnhealthyThreshold’<~Integer> - Specifies the number of consecutive health probe failures required before moving the instance to the Unhealthy state.

Returns

  • response<~Excon::Response>:
    • body<~Hash>:

Create an app cookie stickiness policy

Parameters

  • lb_name<~String> - Name of the ELB
  • policy_name<~String> - The name of the policy being created. The name must be unique within the set of policies for this Load Balancer.
  • cookie_name<~String> - Name of the application cookie used for stickiness.

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request

Create a Load Balancer Cookie Stickiness Policy

Parameters

  • lb_name<~String> - Name of the ELB
  • policy_name<~String> - The name of the policy being created. The name must be unique within the set of policies for this Load Balancer.
  • cookie_expiration_period<~Integer> - The time period in seconds after which the cookie should be considered stale. Not specifying this parameter indicates that the sticky session will last for the duration of the browser session.

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request

Create a new Elastic Load Balancer

Parameters

  • availability_zones<~Array> - List of availability zones for the ELB
  • lb_name<~String> - Name for the new ELB — must be unique
  • listeners<~Array> - Array of Hashes describing ELB listeners to assign to the ELB
    • ‘Protocol’<~String> - Protocol to use. Either HTTP or TCP.
    • ‘LoadBalancerPort’<~Integer> - The port that the ELB will listen to for outside traffic
    • ‘InstancePort’<~Integer> - The port on the instance that the ELB will forward traffic to
    • ‘SSLCertificateId’<~String> - ARN of the server certificate

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request
      • ‘CreateLoadBalancerResult’<~Hash>:
        • ‘DNSName’<~String> - DNS name for the newly created ELB

Create Elastic Load Balancer Listeners

Parameters

  • lb_name<~String> - Name for the new ELB — must be unique
  • listeners<~Array> - Array of Hashes describing ELB listeners to add to the ELB
    • ‘Protocol’<~String> - Protocol to use. Either HTTP or TCP.
    • ‘LoadBalancerPort’<~Integer> - The port that the ELB will listen to for outside traffic
    • ‘InstancePort’<~Integer> - The port on the instance that the ELB will forward traffic to
    • ‘SSLCertificateId’<~String> - ARN of the server certificate

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request

Delete an existing Elastic Load Balancer

Note that this API call, as defined by Amazon, is idempotent. That is, it will not return an error if you try to delete an ELB that does not exist.

Parameters

  • lb_name<~String> - Name of the ELB to be deleted

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘DeleteLoadBalancerResponse’<~nil>
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request

Delet Elastic Load Balancer Listeners

Parameters

  • lb_name<~String> - Name for the new ELB — must be unique
  • load_balancer_ports<~Array> - Array of client port numbers of the LoadBalancerListeners to remove

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request

Delete a Load Balancer Stickiness Policy

Parameters

  • lb_name<~String> - Name of the ELB
  • policy_name<~String> - The name of the policy to delete

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request
deregister_instances(instance_ids, lb_name)

Deregister an instance from an existing ELB

Parameters

  • instance_ids<~Array> - List of instance IDs to remove from ELB
  • lb_name<~String> - Load balancer to remove instances from

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request
      • ‘DeregisterInstancesFromLoadBalancerResult’<~Hash>:
        • ‘Instances’<~Array> - array of hashes describing instances currently enabled
          • ‘InstanceId’<~String>

Get health status for one or more instances on an existing ELB

Parameters

  • lb_name<~String> - Load balancer to check instances health on
  • instance_ids<~Array> - Optional list of instance IDs to check

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request
      • ‘DescribeInstanceHealthResult’<~Hash>:
        • ‘InstanceStates’<~Array> - array of hashes describing instance health
          • ‘Description’<~String>
          • ‘State’<~String>
          • ‘InstanceId’<~String>
          • ‘ReasonCode’<~String>

Describe all or specified load balancers

Parameters

  • lb_name<~Array> - List of load balancer names to describe, defaults to all

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request
      • ‘DescribeLoadBalancersResult’<~Hash>:
        • ‘LoadBalancerDescriptions’<~Array>
          • ‘AvailabilityZones’<~Array> - list of availability zones covered by this load balancer
          • ‘CanonicalHostedZoneName’<~String> - name of the Route 53 hosted zone associated with the load balancer
          • ‘CanonicalHostedZoneNameID’<~String> - ID of the Route 53 hosted zone associated with the load balancer
          • ‘CreatedTime’<~Time> - time load balancer was created
          • ‘DNSName’<~String> - external DNS name of load balancer
          • ‘HealthCheck’<~Hash>:
            • ‘HealthyThreshold’<~Integer> - number of consecutive health probe successes required before moving the instance to the Healthy state
            • ‘Timeout’<~Integer> - number of seconds after which no response means a failed health probe
            • ‘Interval’<~Integer> - interval (in seconds) between health checks of an individual instance
            • ‘UnhealthyThreshold’<~Integer> - number of consecutive health probe failures that move the instance to the unhealthy state
            • ‘Target’<~String> - string describing protocol type, port and URL to check
          • ‘Instances’<~Array> - list of instances that the load balancer balances between
          • ‘ListenerDescriptions’<~Array>
            • ‘PolicyNames’<~Array> - list of policies enabled
            • Listener’<~Hash>:
              • ‘InstancePort’<~Integer> - port on instance that requests are sent to
              • ‘Protocol’<~String> - transport protocol used for routing in [TCP, HTTP]
              • ‘LoadBalancerPort’<~Integer> - port that load balancer listens on for requests
          • ‘LoadBalancerName’<~String> - name of load balancer
          • Policies’<~Hash>:
            • ‘LBCookieStickinessPolicies’<~Array> - list of Load Balancer Generated Cookie Stickiness policies for the LoadBalancer
            • ‘AppCookieStickinessPolicies’<~Array> - list of Application Generated Cookie Stickiness policies for the LoadBalancer
          • ‘SourceSecurityGroup’<~Hash>:
            • ‘GroupName’<~String> - Name of the source security group to use with inbound security group rules
            • ‘OwnerAlias’<~String> - Owner of the source security group

Disable an availability zone for an existing ELB

Parameters

  • availability_zones<~Array> - List of availability zones to disable on ELB
  • lb_name<~String> - Load balancer to disable availability zones on

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request
      • ‘DisableAvailabilityZonesForLoadBalancerResult’<~Hash>:
        • ‘AvailabilityZones’<~Array> - array of strings describing instances currently enabled
disable_zones(availability_zones, lb_name)

Enable an availability zone for an existing ELB

Parameters

  • availability_zones<~Array> - List of availability zones to enable on ELB
  • lb_name<~String> - Load balancer to enable availability zones on

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request
      • ‘EnableAvailabilityZonesForLoadBalancerResult’<~Hash>:
        • ‘AvailabilityZones’<~Array> - array of strings describing instances currently enabled
enable_zones(availability_zones, lb_name)
register_instances(instance_ids, lb_name)

Register an instance with an existing ELB

Parameters

  • instance_ids<~Array> - List of instance IDs to associate with ELB
  • lb_name<~String> - Load balancer to assign instances to

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request
      • ‘RegisterInstancesWithLoadBalancerResult’<~Hash>:
        • ‘Instances’<~Array> - array of hashes describing instances currently enabled
          • ‘InstanceId’<~String>
  • policy_names<~Array> - List of policies to be associated with the listener. Currently this list can have at most one policy. If the list is empty, the current policy is removed from the listener.

Returns

  • response<~Excon::Response>:
    • body<~Hash>:
      • ‘ResponseMetadata’<~Hash>:
        • ‘RequestId’<~String> - Id of request

[Validate]