IAmazonAutoScaling.DetachLoadBalancerTargetGroups Method (DetachLoadBalancerTargetGroupsRequest)

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 DetachLoadBalancerTargetGroups. You can use both the original DetachLoadBalancerTargetGroups API operation and DetachTrafficSources on the same Auto Scaling group.

Detaches one or more target groups from the specified Auto Scaling group.

When you detach a target group, it enters the Removing state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the target group using the DescribeLoadBalancerTargetGroups API call. The instances remain running.

You can use this operation to detach target groups that were attached by using AttachLoadBalancerTargetGroups, but not for target groups that were attached by using AttachTrafficSources.

Note:

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

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

Syntax

public abstract DetachLoadBalancerTargetGroupsResponse DetachLoadBalancerTargetGroups(
         DetachLoadBalancerTargetGroupsRequest request
)

Parameters

request: Type: Amazon.AutoScaling.Model.DetachLoadBalancerTargetGroupsRequest

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

Return Value

Type: DetachLoadBalancerTargetGroupsResponse

The response from the DetachLoadBalancerTargetGroups 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 target group from the specified Auto Scaling group

To detach a target group from an Auto Scaling group


var client = new AmazonAutoScalingClient();
var response = client.DetachLoadBalancerTargetGroups(new DetachLoadBalancerTargetGroupsRequest 
{
    AutoScalingGroupName = "my-auto-scaling-group",
    TargetGroupARNs = new List<string> {
        "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"
    }
});

Version Information

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

IAmazonAutoScaling.DetachLoadBalancerTargetGroups (DetachLoadBalancerTargetGroupsRequest)

Method