AmazonAutoScalingClient.DetachLoadBalancers Method (DetachLoadBalancersRequest)

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.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to DetachLoadBalancersAsync.

Namespace: Amazon.AutoScaling
Assembly: AWSSDK.AutoScaling.dll
Version: 3.x.y.z

Syntax

public virtual DetachLoadBalancersResponse DetachLoadBalancers(
         DetachLoadBalancersRequest request
)

Parameters

request: Type: Amazon.AutoScaling.Model.DetachLoadBalancersRequest

Container for the necessary parameters to execute the DetachLoadBalancers service method.

Return Value

Type: DetachLoadBalancersResponse

The response from the DetachLoadBalancers service method, as returned by AutoScaling.

Exceptions

Exception	Condition
ResourceContentionException	You already have a pending update to an Amazon EC2 Auto Scaling resource (for example, an Auto Scaling group, instance, or load balancer).

Examples

This example detaches the specified load balancer from the specified Auto Scaling group.

To detach a load balancer from an Auto Scaling group


var client = new AmazonAutoScalingClient();
var response = client.DetachLoadBalancers(new DetachLoadBalancersRequest 
{
    AutoScalingGroupName = "my-auto-scaling-group",
    LoadBalancerNames = new List<string> {
        "my-load-balancer"
    }
});

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

AmazonAutoScalingClient.DetachLoadBalancers (DetachLoadBalancersRequest)

Method