|
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.amazonaws.AmazonWebServiceClient
com.amazonaws.services.elasticloadbalancing.AmazonElasticLoadBalancingClient
com.amazonaws.services.elasticloadbalancing.AmazonElasticLoadBalancingAsyncClient
public class AmazonElasticLoadBalancingAsyncClient
Client for accessing AmazonElasticLoadBalancing. All calls made using this client are non-blocking and will immediately return a Java Future. Callers must use the Future object to determine when the service call has actually completed. Elastic Load Balancing
Elastic Load Balancing is a cost-effective and easy to use web service to help you improve availability and scalability of your application. It makes it easy for you to distribute application loads between two or more EC2 instances. Elastic Load Balancing enables availability through redundancy and supports traffic growth of your application.
Constructor Summary | |
---|---|
AmazonElasticLoadBalancingAsyncClient(AWSCredentials awsCredentials)
Constructs a new asynchronous client to invoke service methods on AmazonElasticLoadBalancing using the specified AWS account credentials. |
|
AmazonElasticLoadBalancingAsyncClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration,
ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on AmazonElasticLoadBalancing using the specified AWS account credentials, executor service, and client configuration options. |
|
AmazonElasticLoadBalancingAsyncClient(AWSCredentials awsCredentials,
ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on AmazonElasticLoadBalancing using the specified AWS account credentials and executor service. |
Method Summary | |
---|---|
Future<ConfigureHealthCheckResult> |
configureHealthCheckAsync(ConfigureHealthCheckRequest configureHealthCheckRequest)
Enables the client to define an application healthcheck for the instances. |
Future<CreateAppCookieStickinessPolicyResult> |
createAppCookieStickinessPolicyAsync(CreateAppCookieStickinessPolicyRequest createAppCookieStickinessPolicyRequest)
Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. |
Future<CreateLBCookieStickinessPolicyResult> |
createLBCookieStickinessPolicyAsync(CreateLBCookieStickinessPolicyRequest createLBCookieStickinessPolicyRequest)
Generates a stickiness policy with sticky session lifetimes controlled by the lifetime of the browser (user-agent) or a specified expiration period. |
Future<CreateLoadBalancerResult> |
createLoadBalancerAsync(CreateLoadBalancerRequest createLoadBalancerRequest)
Creates a new LoadBalancer. |
Future<Void> |
createLoadBalancerListenersAsync(CreateLoadBalancerListenersRequest createLoadBalancerListenersRequest)
Creates one or more listeners on a LoadBalancer for the specified port. |
Future<Void> |
deleteLoadBalancerAsync(DeleteLoadBalancerRequest deleteLoadBalancerRequest)
Deletes the specified LoadBalancer. |
Future<Void> |
deleteLoadBalancerListenersAsync(DeleteLoadBalancerListenersRequest deleteLoadBalancerListenersRequest)
Deletes listeners from the LoadBalancer for the specified port. |
Future<DeleteLoadBalancerPolicyResult> |
deleteLoadBalancerPolicyAsync(DeleteLoadBalancerPolicyRequest deleteLoadBalancerPolicyRequest)
Deletes a policy from the LoadBalancer. |
Future<DeregisterInstancesFromLoadBalancerResult> |
deregisterInstancesFromLoadBalancerAsync(DeregisterInstancesFromLoadBalancerRequest deregisterInstancesFromLoadBalancerRequest)
Deregisters instances from the LoadBalancer. |
Future<DescribeInstanceHealthResult> |
describeInstanceHealthAsync(DescribeInstanceHealthRequest describeInstanceHealthRequest)
Returns the current state of the instances of the specified LoadBalancer. |
Future<DescribeLoadBalancersResult> |
describeLoadBalancersAsync(DescribeLoadBalancersRequest describeLoadBalancersRequest)
Returns detailed configuration information for the specified LoadBalancers. |
Future<DisableAvailabilityZonesForLoadBalancerResult> |
disableAvailabilityZonesForLoadBalancerAsync(DisableAvailabilityZonesForLoadBalancerRequest disableAvailabilityZonesForLoadBalancerRequest)
Removes the specified EC2 Availability Zones from the set of configured Availability Zones for the LoadBalancer. |
Future<EnableAvailabilityZonesForLoadBalancerResult> |
enableAvailabilityZonesForLoadBalancerAsync(EnableAvailabilityZonesForLoadBalancerRequest enableAvailabilityZonesForLoadBalancerRequest)
Adds one or more EC2 Availability Zones to the LoadBalancer. |
ExecutorService |
getExecutorService()
Returns the executor service used by this async client to execute requests. |
Future<RegisterInstancesWithLoadBalancerResult> |
registerInstancesWithLoadBalancerAsync(RegisterInstancesWithLoadBalancerRequest registerInstancesWithLoadBalancerRequest)
Adds new instances to the LoadBalancer. |
Future<Void> |
setLoadBalancerListenerSSLCertificateAsync(SetLoadBalancerListenerSSLCertificateRequest setLoadBalancerListenerSSLCertificateRequest)
Sets the certificate that terminates the specified listener's SSL connections. |
Future<SetLoadBalancerPoliciesOfListenerResult> |
setLoadBalancerPoliciesOfListenerAsync(SetLoadBalancerPoliciesOfListenerRequest setLoadBalancerPoliciesOfListenerRequest)
Associates, updates, or disables a policy with a listener on the load balancer. |
Methods inherited from class com.amazonaws.AmazonWebServiceClient |
---|
setEndpoint, shutdown |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public AmazonElasticLoadBalancingAsyncClient(AWSCredentials awsCredentials)
All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.public AmazonElasticLoadBalancingAsyncClient(AWSCredentials awsCredentials, ExecutorService executorService)
All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.executorService
- The executor service by which all asynchronous requests will
be executed.public AmazonElasticLoadBalancingAsyncClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration, ExecutorService executorService)
All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.clientConfiguration
- Client configuration options (ex: max retry limit, proxy
settings, etc).executorService
- The executor service by which all asynchronous requests will
be executed.Method Detail |
---|
public ExecutorService getExecutorService()
public Future<Void> createLoadBalancerListenersAsync(CreateLoadBalancerListenersRequest createLoadBalancerListenersRequest) throws AmazonServiceException, AmazonClientException
Creates one or more listeners on a LoadBalancer for the specified port. If a listener with the given port does not already exist, it will be created; otherwise, the properties of the new listener must match the properties of the existing listener.
createLoadBalancerListenersAsync
in interface AmazonElasticLoadBalancingAsync
createLoadBalancerListenersRequest
- Container for the necessary
parameters to execute the CreateLoadBalancerListeners operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<Void> deleteLoadBalancerListenersAsync(DeleteLoadBalancerListenersRequest deleteLoadBalancerListenersRequest) throws AmazonServiceException, AmazonClientException
Deletes listeners from the LoadBalancer for the specified port.
deleteLoadBalancerListenersAsync
in interface AmazonElasticLoadBalancingAsync
deleteLoadBalancerListenersRequest
- Container for the necessary
parameters to execute the DeleteLoadBalancerListeners operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<ConfigureHealthCheckResult> configureHealthCheckAsync(ConfigureHealthCheckRequest configureHealthCheckRequest) throws AmazonServiceException, AmazonClientException
Enables the client to define an application healthcheck for the instances.
configureHealthCheckAsync
in interface AmazonElasticLoadBalancingAsync
configureHealthCheckRequest
- Container for the necessary
parameters to execute the ConfigureHealthCheck operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<DescribeLoadBalancersResult> describeLoadBalancersAsync(DescribeLoadBalancersRequest describeLoadBalancersRequest) throws AmazonServiceException, AmazonClientException
Returns detailed configuration information for the specified LoadBalancers. If no LoadBalancers are specified, the operation returns configuration information for all LoadBalancers created by the caller.
NOTE: The client must have created the specified input LoadBalancers in order to retrieve this information; the client must provide the same account credentials as those that were used to create the LoadBalancer.
describeLoadBalancersAsync
in interface AmazonElasticLoadBalancingAsync
describeLoadBalancersRequest
- Container for the necessary
parameters to execute the DescribeLoadBalancers operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<CreateLBCookieStickinessPolicyResult> createLBCookieStickinessPolicyAsync(CreateLBCookieStickinessPolicyRequest createLBCookieStickinessPolicyRequest) throws AmazonServiceException, AmazonClientException
Generates a stickiness policy with sticky session lifetimes controlled by the lifetime of the browser (user-agent) or a specified expiration period. This policy can only be associated only with HTTP listeners.
When a load balancer implements this policy, the load balancer uses a special cookie to track the backend server instance for each request. When the load balancer receives a request, it first checks to see if this cookie is present in the request. If so, the load balancer sends the request to the application server specified in the cookie. If not, the load balancer sends the request to a server that is chosen based on the existing load balancing algorithm.
A cookie is inserted into the response for binding subsequent requests from the same user to that server. The validity of the cookie is based on the cookie expiration time, which is specified in the policy configuration.
createLBCookieStickinessPolicyAsync
in interface AmazonElasticLoadBalancingAsync
createLBCookieStickinessPolicyRequest
- Container for the
necessary parameters to execute the CreateLBCookieStickinessPolicy
operation on AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<EnableAvailabilityZonesForLoadBalancerResult> enableAvailabilityZonesForLoadBalancerAsync(EnableAvailabilityZonesForLoadBalancerRequest enableAvailabilityZonesForLoadBalancerRequest) throws AmazonServiceException, AmazonClientException
Adds one or more EC2 Availability Zones to the LoadBalancer.
The LoadBalancer evenly distributes requests across all its registered Availability Zones that contain instances. As a result, the client must ensure that its LoadBalancer is appropriately scaled for each registered Availability Zone.
NOTE: The new EC2 Availability Zones to be added must be in the same EC2 Region as the Availability Zones for which the LoadBalancer was created.
enableAvailabilityZonesForLoadBalancerAsync
in interface AmazonElasticLoadBalancingAsync
enableAvailabilityZonesForLoadBalancerRequest
- Container for the
necessary parameters to execute the
EnableAvailabilityZonesForLoadBalancer operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<DescribeInstanceHealthResult> describeInstanceHealthAsync(DescribeInstanceHealthRequest describeInstanceHealthRequest) throws AmazonServiceException, AmazonClientException
Returns the current state of the instances of the specified LoadBalancer. If no instances are specified, the state of all the instances for the LoadBalancer is returned.
NOTE: The client must have created the specified input LoadBalancer in order to retrieve this information; the client must provide the same account credentials as those that were used to create the LoadBalancer.
describeInstanceHealthAsync
in interface AmazonElasticLoadBalancingAsync
describeInstanceHealthRequest
- Container for the necessary
parameters to execute the DescribeInstanceHealth operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<Void> setLoadBalancerListenerSSLCertificateAsync(SetLoadBalancerListenerSSLCertificateRequest setLoadBalancerListenerSSLCertificateRequest) throws AmazonServiceException, AmazonClientException
Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces any prior certificate that was used on the same LoadBalancer and port.
setLoadBalancerListenerSSLCertificateAsync
in interface AmazonElasticLoadBalancingAsync
setLoadBalancerListenerSSLCertificateRequest
- Container for the
necessary parameters to execute the
SetLoadBalancerListenerSSLCertificate operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<SetLoadBalancerPoliciesOfListenerResult> setLoadBalancerPoliciesOfListenerAsync(SetLoadBalancerPoliciesOfListenerRequest setLoadBalancerPoliciesOfListenerRequest) throws AmazonServiceException, AmazonClientException
Associates, updates, or disables a policy with a listener on the load balancer. Currently only zero (0) or one (1) policy can be associated with a listener.
setLoadBalancerPoliciesOfListenerAsync
in interface AmazonElasticLoadBalancingAsync
setLoadBalancerPoliciesOfListenerRequest
- Container for the
necessary parameters to execute the SetLoadBalancerPoliciesOfListener
operation on AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<CreateLoadBalancerResult> createLoadBalancerAsync(CreateLoadBalancerRequest createLoadBalancerRequest) throws AmazonServiceException, AmazonClientException
Creates a new LoadBalancer.
Once the call has completed successfully, a new LoadBalancer is created; however, it will not be usable until at least one instance has been registered. When the LoadBalancer creation is completed, the client can check whether or not it is usable by using the DescribeInstanceHealth API. The LoadBalancer is usable as soon as any registered instance is InService .
NOTE: Currently, the client's quota of LoadBalancers is limited to five per Region.
NOTE: Load balancer DNS names vary depending on the Region they're created in. For load balancers created in the United States, the DNS name ends with: us-east-1.elb.amazonaws.com (for the US Standard Region) us-west-1.elb.amazonaws.com (for the Northern California Region) For load balancers created in the EU (Ireland) Region, the DNS name ends with: eu-west-1.elb.amazonaws.com
createLoadBalancerAsync
in interface AmazonElasticLoadBalancingAsync
createLoadBalancerRequest
- Container for the necessary
parameters to execute the CreateLoadBalancer operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<RegisterInstancesWithLoadBalancerResult> registerInstancesWithLoadBalancerAsync(RegisterInstancesWithLoadBalancerRequest registerInstancesWithLoadBalancerRequest) throws AmazonServiceException, AmazonClientException
Adds new instances to the LoadBalancer.
Once the instance is registered, it starts receiving traffic and requests from the LoadBalancer. Any instance that is not in any of the Availability Zones registered for the LoadBalancer will be moved to the OutOfService state. It will move to the InService state when the Availability Zone is added to the LoadBalancer.
NOTE: In order for this call to be successful, the client must have created the LoadBalancer. The client must provide the same account credentials as those that were used to create the LoadBalancer.
NOTE: Completion of this API does not guarantee that operation has completed. Rather, it means that the request has been registered and the changes will happen shortly.
registerInstancesWithLoadBalancerAsync
in interface AmazonElasticLoadBalancingAsync
registerInstancesWithLoadBalancerRequest
- Container for the
necessary parameters to execute the RegisterInstancesWithLoadBalancer
operation on AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<CreateAppCookieStickinessPolicyResult> createAppCookieStickinessPolicyAsync(CreateAppCookieStickinessPolicyRequest createAppCookieStickinessPolicyRequest) throws AmazonServiceException, AmazonClientException
Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. This policy can only be associated with HTTP listeners.
This policy is similar to the policy created by CreateLBCookieStickinessPolicy, except that the lifetime of the special Elastic Load Balancing cookie follows the lifetime of the application-generated cookie specified in the policy configuration. The load balancer only inserts a new stickiness cookie when the application response includes a new application cookie.
If the application cookie is explicitly removed or expires, the session stops being sticky until a new application cookie is issued.
createAppCookieStickinessPolicyAsync
in interface AmazonElasticLoadBalancingAsync
createAppCookieStickinessPolicyRequest
- Container for the
necessary parameters to execute the CreateAppCookieStickinessPolicy
operation on AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<Void> deleteLoadBalancerAsync(DeleteLoadBalancerRequest deleteLoadBalancerRequest) throws AmazonServiceException, AmazonClientException
Deletes the specified LoadBalancer.
If attempting to recreate the LoadBalancer, the client must reconfigure all the settings. The DNS name associated with a deleted LoadBalancer will no longer be usable. Once deleted, the name and associated DNS record of the LoadBalancer no longer exist and traffic sent to any of its IP addresses will no longer be delivered to client instances. The client will not receive the same DNS name even if a new LoadBalancer with same LoadBalancerName is created.
To successfully call this API, the client must provide the same account credentials as were used to create the LoadBalancer.
NOTE: By design, if the LoadBalancer does not exist or has already been deleted, DeleteLoadBalancer still succeeds.
deleteLoadBalancerAsync
in interface AmazonElasticLoadBalancingAsync
deleteLoadBalancerRequest
- Container for the necessary
parameters to execute the DeleteLoadBalancer operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<DisableAvailabilityZonesForLoadBalancerResult> disableAvailabilityZonesForLoadBalancerAsync(DisableAvailabilityZonesForLoadBalancerRequest disableAvailabilityZonesForLoadBalancerRequest) throws AmazonServiceException, AmazonClientException
Removes the specified EC2 Availability Zones from the set of configured Availability Zones for the LoadBalancer.
There must be at least one Availability Zone registered with a LoadBalancer at all times. A client cannot remove all the Availability Zones from a LoadBalancer. Once an Availability Zone is removed, all the instances registered with the LoadBalancer that are in the removed Availability Zone go into the OutOfService state. Upon Availability Zone removal, the LoadBalancer attempts to equally balance the traffic among its remaining usable Availability Zones. Trying to remove an Availability Zone that was not associated with the LoadBalancer does nothing.
NOTE: In order for this call to be successful, the client must have created the LoadBalancer. The client must provide the same account credentials as those that were used to create the LoadBalancer.
disableAvailabilityZonesForLoadBalancerAsync
in interface AmazonElasticLoadBalancingAsync
disableAvailabilityZonesForLoadBalancerRequest
- Container for
the necessary parameters to execute the
DisableAvailabilityZonesForLoadBalancer operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<DeleteLoadBalancerPolicyResult> deleteLoadBalancerPolicyAsync(DeleteLoadBalancerPolicyRequest deleteLoadBalancerPolicyRequest) throws AmazonServiceException, AmazonClientException
Deletes a policy from the LoadBalancer. The specified policy must not be enabled for any listeners.
deleteLoadBalancerPolicyAsync
in interface AmazonElasticLoadBalancingAsync
deleteLoadBalancerPolicyRequest
- Container for the necessary
parameters to execute the DeleteLoadBalancerPolicy operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.public Future<DeregisterInstancesFromLoadBalancerResult> deregisterInstancesFromLoadBalancerAsync(DeregisterInstancesFromLoadBalancerRequest deregisterInstancesFromLoadBalancerRequest) throws AmazonServiceException, AmazonClientException
Deregisters instances from the LoadBalancer. Once the instance is deregistered, it will stop receiving traffic from the LoadBalancer.
In order to successfully call this API, the same account credentials as those used to create the LoadBalancer must be provided.
deregisterInstancesFromLoadBalancerAsync
in interface AmazonElasticLoadBalancingAsync
deregisterInstancesFromLoadBalancerRequest
- Container for the
necessary parameters to execute the
DeregisterInstancesFromLoadBalancer operation on
AmazonElasticLoadBalancing.
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.
AmazonServiceException
- If an error response is returned by AmazonElasticLoadBalancing indicating
either a problem with the data in the request, or a server side issue.
|
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |