Method: Aws::ElasticLoadBalancing::Client#disable_availability_zones_for_load_balancer

Defined in:
lib/aws-sdk-elasticloadbalancing/client.rb

#disable_availability_zones_for_load_balancer(params = {}) ⇒ Types::RemoveAvailabilityZonesOutput

Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer in EC2-Classic or a default VPC.

For load balancers in a non-default VPC, use DetachLoadBalancerFromSubnets.

There must be at least one Availability Zone registered with a load balancer at all times. After an Availability Zone is removed, all instances registered with the load balancer that are in the removed Availability Zone go into the OutOfService state. Then, the load balancer attempts to equally balance the traffic among its remaining Availability Zones.

For more information, see [Add or Remove Availability Zones] in the *Classic Load Balancers Guide*.

[1]: docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html

Examples:

Example: To disable an Availability Zone for a load balancer


# This example removes the specified Availability Zone from the set of Availability Zones for the specified load balancer.

resp = client.disable_availability_zones_for_load_balancer({
  availability_zones: [
    "us-west-2a", 
  ], 
  load_balancer_name: "my-load-balancer", 
})

resp.to_h outputs the following:
{
  availability_zones: [
    "us-west-2b", 
  ], 
}

Request syntax with placeholder values


resp = client.disable_availability_zones_for_load_balancer({
  load_balancer_name: "AccessPointName", # required
  availability_zones: ["AvailabilityZone"], # required
})

Response structure


resp.availability_zones #=> Array
resp.availability_zones[0] #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :load_balancer_name (required, String) —

    The name of the load balancer.

  • :availability_zones (required, Array<String>) —

    The Availability Zones.

Returns:

See Also:



2221
2222
2223
2224
 
# File 'lib/aws-sdk-elasticloadbalancing/client.rb', line 2221

def disable_availability_zones_for_load_balancer(params = {}, options = {})
  req = build_request(:disable_availability_zones_for_load_balancer, params)
  req.send_request(options)
end