DetachLoadBalancerTargetGroups
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 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.
Note
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.
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
- TargetGroupARNs.member.N
-
The Amazon Resource Names (ARN) of the target groups. You can specify up to 10 target groups.
Type: Array of strings
Length Constraints: Minimum length of 1. Maximum length of 511.
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
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: