DetachLoadBalancers
Note
This API operation is superseded by DetachTrafficSources, which
can detach multiple traffic sources types. We recommend using
DetachTrafficSources
to simplify how you manage traffic sources.
However, we continue to support DetachLoadBalancers
. You can use both
the original DetachLoadBalancers
API operation and
DetachTrafficSources
on the same Auto Scaling group.
Detaches one or more Classic Load Balancers from the specified Auto Scaling group.
This operation detaches only Classic Load Balancers. If you have Application Load Balancers, Network Load Balancers, or Gateway Load Balancers, use the DetachLoadBalancerTargetGroups API instead.
When you detach a load balancer, it enters the Removing
state while
deregistering the instances in the group. When all instances are deregistered, then you
can no longer describe the load balancer using the DescribeLoadBalancers
API call. The instances remain running.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- AutoScalingGroupName
-
The name of the Auto Scaling group.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
Required: Yes
- LoadBalancerNames.member.N
-
The names of the load balancers. You can specify up to 10 load balancers.
Type: Array of strings
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
Required: Yes
Errors
For information about the errors that are common to all actions, see Common Errors.
- ResourceContention
-
You already have a pending update to an Amazon EC2 Auto Scaling resource (for example, an Auto Scaling group, instance, or load balancer).
HTTP Status Code: 500
Examples
Example
This example illustrates one usage of DetachLoadBalancers.
Sample Request
https://autoscaling.amazonaws.com/?Action=DetachLoadBalancers
&AutoScalingGroupName=my-asg
&LoadBalancerNames.member.1=my-lb
&Version=2011-01-01
&AUTHPARAMS
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: