RegisterTargets
Registers the specified targets with the specified target group.
If the target is an EC2 instance, it must be in the running
state when you
register it.
By default, the load balancer routes requests to registered targets using the protocol and port for the target group. Alternatively, you can override the port for a target when you register it. You can register each EC2 instance or IP address with the same target group multiple times using different ports.
With a Network Load Balancer, you cannot register instances by instance ID if they have the following instance types: C1, CC1, CC2, CG1, CG2, CR1, CS1, G1, G2, HI1, HS1, M1, M2, M3, and T1. You can register instances of these types by IP address.
To remove a target from a target group, use DeregisterTargets.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- TargetGroupArn
-
The Amazon Resource Name (ARN) of the target group.
Type: String
Required: Yes
- Targets.member.N
-
The targets.
Type: Array of TargetDescription objects
Required: Yes
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidTarget
-
The specified target does not exist, is not in the same VPC as the target group, or has an unsupported instance type.
HTTP Status Code: 400
- TargetGroupNotFound
-
The specified target group does not exist.
HTTP Status Code: 400
- TooManyRegistrationsForTargetId
-
You've reached the limit on the number of times a target can be registered with a load balancer.
HTTP Status Code: 400
- TooManyTargets
-
You've reached the limit on the number of targets.
HTTP Status Code: 400
Examples
Register targets by instance ID
This example registers the specified instance IDs with the specified target group.
Sample Request
https://elasticloadbalancing.amazonaws.com/?Action=RegisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=i-80c8dd94
&Targets.member.2.Id=i-ceddcd4d
&Version=2015-12-01
&AUTHPARAMS
Register targets by IP address
This example registers the specified IP addresses with the specified target group.
Sample Request
https://elasticloadbalancing.amazonaws.com/?Action=RegisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=10.0.42.17
&Targets.member.2.Id=192.168.0.3
&Targets.member.2.AvailabilityZone=all
&Version=2015-12-01
&AUTHPARAMS
Register targets by instance ID using port overrides
This example registers the specified instance with the specified target group using multiple ports. This enables you to register microservices on the same instance as targets in the target group.
Sample Request
https://elasticloadbalancing.amazonaws.com/?Action=RegisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=i-80c8dd94
&Targets.member.1.Port=80
&Targets.member.2.Id=i-80c8dd94
&Targets.member.2.Port=766
&Version=2015-12-01
&AUTHPARAMS
Register a Lambda function as a target
This example registers the specified Lambda function with the specified target group. You must grant Elastic Load Balancing permission to invoke the Lambda function. For more information, see Lambda functions as targets in the Application Load Balancers Guide.
Sample Request
https://elasticloadbalancing.amazonaws.com/?Action=RegisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=aws:lambda:us-west-2:123456789012:function:my-function
&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: