Elastic Load Balancing
API Reference (API Version 2015-12-01)


Deregisters the specified targets from the specified target group. After the targets are deregistered, they no longer receive traffic from the load balancer.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.


The Amazon Resource Name (ARN) of the target group.

Type: String

Required: Yes


The targets. If you specified a port override when you registered a target, you must specify both the target ID and the port when you deregister it.

Type: Array of TargetDescription objects

Required: Yes


For information about the errors that are common to all actions, see Common Errors.


The specified target does not exist or is not in the same VPC as the target group.

HTTP Status Code: 400


The specified target group does not exist.

HTTP Status Code: 400


Deregister a target from a target group

This example deregisters the specified instance from the specified target group.

Sample Request

Copy &TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 &Targets.member.1.Id=i-0f76fade &Version=2015-12-01 &AUTHPARAMS

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: