public class RegisterInstancesWithLoadBalancerRequest extends AmazonWebServiceRequest implements java.io.Serializable
Adds the specified instances to the specified load balancer.
The instance must be a running instance in the same network as the load balancer (EC2-Classic or the same VPC). If you have EC2-Classic instances and a load balancer in a VPC with ClassicLink enabled, you can link the EC2-Classic instances to that VPC and then register the linked EC2-Classic instances with the load balancer in the VPC.
Note that RegisterInstanceWithLoadBalancer
completes when the
request has been registered. Instance registration takes a little time to
complete. To check the state of the registered instances, use
DescribeLoadBalancers or DescribeInstanceHealth.
After the instance is registered, it starts receiving traffic and requests
from the load balancer. Any instance that is not in one of the Availability
Zones registered for the load balancer is moved to the
OutOfService
state. If an Availability Zone is added to the load
balancer later, any instances registered with the load balancer move to the
InService
state.
If you stop an instance registered with a load balancer and then start it, the IP addresses associated with the instance changes. Elastic Load Balancing cannot recognize the new IP address, which prevents it from routing traffic to the instances. We recommend that you use the following sequence: stop the instance, deregister the instance, start the instance, and then register the instance. To deregister instances from a load balancer, use DeregisterInstancesFromLoadBalancer.
For more information, see Deregister and Register EC2 Instances in the Elastic Load Balancing Developer Guide.
Constructor and Description |
---|
RegisterInstancesWithLoadBalancerRequest()
Default constructor for RegisterInstancesWithLoadBalancerRequest object.
|
RegisterInstancesWithLoadBalancerRequest(java.lang.String loadBalancerName,
java.util.List<Instance> instances)
Constructs a new RegisterInstancesWithLoadBalancerRequest object.
|
Modifier and Type | Method and Description |
---|---|
boolean |
equals(java.lang.Object obj) |
java.util.List<Instance> |
getInstances()
The IDs of the instances.
|
java.lang.String |
getLoadBalancerName()
The name of the load balancer.
|
int |
hashCode() |
void |
setInstances(java.util.Collection<Instance> instances)
The IDs of the instances.
|
void |
setLoadBalancerName(java.lang.String loadBalancerName)
The name of the load balancer.
|
java.lang.String |
toString()
Returns a string representation of this object; useful for testing and
debugging.
|
RegisterInstancesWithLoadBalancerRequest |
withInstances(java.util.Collection<Instance> instances)
The IDs of the instances.
|
RegisterInstancesWithLoadBalancerRequest |
withInstances(Instance... instances)
The IDs of the instances.
|
RegisterInstancesWithLoadBalancerRequest |
withLoadBalancerName(java.lang.String loadBalancerName)
The name of the load balancer.
|
clone, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector
public RegisterInstancesWithLoadBalancerRequest()
public RegisterInstancesWithLoadBalancerRequest(java.lang.String loadBalancerName, java.util.List<Instance> instances)
loadBalancerName
- The name of the load balancer.
instances
- The IDs of the instances.
public java.lang.String getLoadBalancerName()
The name of the load balancer.
The name of the load balancer.
public void setLoadBalancerName(java.lang.String loadBalancerName)
The name of the load balancer.
loadBalancerName
- The name of the load balancer.
public RegisterInstancesWithLoadBalancerRequest withLoadBalancerName(java.lang.String loadBalancerName)
The name of the load balancer.
Returns a reference to this object so that method calls can be chained together.
loadBalancerName
- The name of the load balancer.
public java.util.List<Instance> getInstances()
The IDs of the instances.
The IDs of the instances.
public void setInstances(java.util.Collection<Instance> instances)
The IDs of the instances.
instances
- The IDs of the instances.
public RegisterInstancesWithLoadBalancerRequest withInstances(Instance... instances)
The IDs of the instances.
Returns a reference to this object so that method calls can be chained together.
instances
- The IDs of the instances.
public RegisterInstancesWithLoadBalancerRequest withInstances(java.util.Collection<Instance> instances)
The IDs of the instances.
Returns a reference to this object so that method calls can be chained together.
instances
- The IDs of the instances.
public java.lang.String toString()
toString
in class java.lang.Object
Object.toString()
public int hashCode()
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
Copyright © 2010 Amazon Web Services, Inc. All Rights Reserved.