/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.elasticloadbalancing; import javax.annotation.Generated; import com.amazonaws.services.elasticloadbalancing.model.*; /** * Interface for accessing Elastic Load Balancing asynchronously. Each asynchronous method will return a Java Future * object representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.elasticloadbalancing.AbstractAmazonElasticLoadBalancingAsync} instead. *
*
*
* A load balancer can distribute incoming traffic across your EC2 instances. This enables you to increase the * availability of your application. The load balancer also monitors the health of its registered instances and ensures * that it routes traffic only to healthy instances. You configure your load balancer to accept incoming traffic by * specifying one or more listeners, which are configured with a protocol and port number for connections from clients * to the load balancer and a protocol and port number for connections from the load balancer to the instances. *
** Elastic Load Balancing supports three types of load balancers: Application Load Balancers, Network Load Balancers, * and Classic Load Balancers. You can select a load balancer based on your application needs. For more information, see * the Elastic Load Balancing User * Guide. *
** This reference covers the 2012-06-01 API, which supports Classic Load Balancers. The 2015-12-01 API supports * Application Load Balancers and Network Load Balancers. *
** To get started, create a load balancer with one or more listeners using CreateLoadBalancer. Register your * instances with the load balancer using RegisterInstancesWithLoadBalancer. *
** All Elastic Load Balancing operations are idempotent, which means that they complete at most one time. If you * repeat an operation, it succeeds with a 200 OK response code. *
*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AmazonElasticLoadBalancingAsync extends AmazonElasticLoadBalancing { /** ** Adds the specified tags to the specified load balancer. Each load balancer can have a maximum of 10 tags. *
*
* Each tag consists of a key and an optional value. If a tag with the same key is already associated with the load
* balancer, AddTags
updates its value.
*
* For more information, see Tag Your Classic Load * Balancer in the Classic Load Balancers Guide. *
* * @param addTagsRequest * Contains the parameters for AddTags. * @return A Java Future containing the result of the AddTags operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.AddTags * @see AWS * API Documentation */ java.util.concurrent.Future* Adds the specified tags to the specified load balancer. Each load balancer can have a maximum of 10 tags. *
*
* Each tag consists of a key and an optional value. If a tag with the same key is already associated with the load
* balancer, AddTags
updates its value.
*
* For more information, see Tag Your Classic Load * Balancer in the Classic Load Balancers Guide. *
* * @param addTagsRequest * Contains the parameters for AddTags. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AddTags operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.AddTags * @see AWS * API Documentation */ java.util.concurrent.Future* Associates one or more security groups with your load balancer in a virtual private cloud (VPC). The specified * security groups override the previously associated security groups. *
** For more information, see Security Groups for Load Balancers in a VPC in the Classic Load Balancers Guide. *
* * @param applySecurityGroupsToLoadBalancerRequest * Contains the parameters for ApplySecurityGroupsToLoadBalancer. * @return A Java Future containing the result of the ApplySecurityGroupsToLoadBalancer operation returned by the * service. * @sample AmazonElasticLoadBalancingAsync.ApplySecurityGroupsToLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Associates one or more security groups with your load balancer in a virtual private cloud (VPC). The specified * security groups override the previously associated security groups. *
** For more information, see Security Groups for Load Balancers in a VPC in the Classic Load Balancers Guide. *
* * @param applySecurityGroupsToLoadBalancerRequest * Contains the parameters for ApplySecurityGroupsToLoadBalancer. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ApplySecurityGroupsToLoadBalancer operation returned by the * service. * @sample AmazonElasticLoadBalancingAsyncHandler.ApplySecurityGroupsToLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Adds one or more subnets to the set of configured subnets for the specified load balancer. *
** The load balancer evenly distributes requests across all registered subnets. For more information, see Add or Remove * Subnets for Your Load Balancer in a VPC in the Classic Load Balancers Guide. *
* * @param attachLoadBalancerToSubnetsRequest * Contains the parameters for AttachLoaBalancerToSubnets. * @return A Java Future containing the result of the AttachLoadBalancerToSubnets operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.AttachLoadBalancerToSubnets * @see AWS API Documentation */ java.util.concurrent.Future* Adds one or more subnets to the set of configured subnets for the specified load balancer. *
** The load balancer evenly distributes requests across all registered subnets. For more information, see Add or Remove * Subnets for Your Load Balancer in a VPC in the Classic Load Balancers Guide. *
* * @param attachLoadBalancerToSubnetsRequest * Contains the parameters for AttachLoaBalancerToSubnets. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AttachLoadBalancerToSubnets operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.AttachLoadBalancerToSubnets * @see AWS API Documentation */ java.util.concurrent.Future* Specifies the health check settings to use when evaluating the health state of your EC2 instances. *
** For more information, see Configure Health * Checks for Your Load Balancer in the Classic Load Balancers Guide. *
* * @param configureHealthCheckRequest * Contains the parameters for ConfigureHealthCheck. * @return A Java Future containing the result of the ConfigureHealthCheck operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.ConfigureHealthCheck * @see AWS API Documentation */ java.util.concurrent.Future* Specifies the health check settings to use when evaluating the health state of your EC2 instances. *
** For more information, see Configure Health * Checks for Your Load Balancer in the Classic Load Balancers Guide. *
* * @param configureHealthCheckRequest * Contains the parameters for ConfigureHealthCheck. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ConfigureHealthCheck operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.ConfigureHealthCheck * @see AWS API Documentation */ java.util.concurrent.Future* Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. * This policy can be associated only with HTTP/HTTPS listeners. *
*
* This policy is similar to the policy created by CreateLBCookieStickinessPolicy, except that the lifetime
* of the special Elastic Load Balancing cookie, AWSELB
, 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. *
** For more information, see Application-Controlled Session Stickiness in the Classic Load Balancers Guide. *
* * @param createAppCookieStickinessPolicyRequest * Contains the parameters for CreateAppCookieStickinessPolicy. * @return A Java Future containing the result of the CreateAppCookieStickinessPolicy operation returned by the * service. * @sample AmazonElasticLoadBalancingAsync.CreateAppCookieStickinessPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. * This policy can be associated only with HTTP/HTTPS listeners. *
*
* This policy is similar to the policy created by CreateLBCookieStickinessPolicy, except that the lifetime
* of the special Elastic Load Balancing cookie, AWSELB
, 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. *
** For more information, see Application-Controlled Session Stickiness in the Classic Load Balancers Guide. *
* * @param createAppCookieStickinessPolicyRequest * Contains the parameters for CreateAppCookieStickinessPolicy. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateAppCookieStickinessPolicy operation returned by the * service. * @sample AmazonElasticLoadBalancingAsyncHandler.CreateAppCookieStickinessPolicy * @see AWS API Documentation */ java.util.concurrent.Future* 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 be associated only with HTTP/HTTPS listeners. *
** When a load balancer implements this policy, the load balancer uses a special cookie to track the 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. *
** For more information, see Duration-Based Session Stickiness in the Classic Load Balancers Guide. *
* * @param createLBCookieStickinessPolicyRequest * Contains the parameters for CreateLBCookieStickinessPolicy. * @return A Java Future containing the result of the CreateLBCookieStickinessPolicy operation returned by the * service. * @sample AmazonElasticLoadBalancingAsync.CreateLBCookieStickinessPolicy * @see AWS API Documentation */ java.util.concurrent.Future* 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 be associated only with HTTP/HTTPS listeners. *
** When a load balancer implements this policy, the load balancer uses a special cookie to track the 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. *
** For more information, see Duration-Based Session Stickiness in the Classic Load Balancers Guide. *
* * @param createLBCookieStickinessPolicyRequest * Contains the parameters for CreateLBCookieStickinessPolicy. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateLBCookieStickinessPolicy operation returned by the * service. * @sample AmazonElasticLoadBalancingAsyncHandler.CreateLBCookieStickinessPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Creates a Classic Load Balancer. *
** You can add listeners, security groups, subnets, and tags when you create your load balancer, or you can add them * later using CreateLoadBalancerListeners, ApplySecurityGroupsToLoadBalancer, * AttachLoadBalancerToSubnets, and AddTags. *
** To describe your current load balancers, see DescribeLoadBalancers. When you are finished with a load * balancer, you can delete it using DeleteLoadBalancer. *
** You can create up to 20 load balancers per region per account. You can request an increase for the number of load * balancers for your account. For more information, see Limits for Your Classic * Load Balancer in the Classic Load Balancers Guide. *
* * @param createLoadBalancerRequest * Contains the parameters for CreateLoadBalancer. * @return A Java Future containing the result of the CreateLoadBalancer operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.CreateLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Creates a Classic Load Balancer. *
** You can add listeners, security groups, subnets, and tags when you create your load balancer, or you can add them * later using CreateLoadBalancerListeners, ApplySecurityGroupsToLoadBalancer, * AttachLoadBalancerToSubnets, and AddTags. *
** To describe your current load balancers, see DescribeLoadBalancers. When you are finished with a load * balancer, you can delete it using DeleteLoadBalancer. *
** You can create up to 20 load balancers per region per account. You can request an increase for the number of load * balancers for your account. For more information, see Limits for Your Classic * Load Balancer in the Classic Load Balancers Guide. *
* * @param createLoadBalancerRequest * Contains the parameters for CreateLoadBalancer. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateLoadBalancer operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.CreateLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Creates one or more listeners for the specified load balancer. If a listener with the specified port does not * already exist, it is created; otherwise, the properties of the new listener must match the properties of the * existing listener. *
** For more information, see Listeners for * Your Classic Load Balancer in the Classic Load Balancers Guide. *
* * @param createLoadBalancerListenersRequest * Contains the parameters for CreateLoadBalancerListeners. * @return A Java Future containing the result of the CreateLoadBalancerListeners operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.CreateLoadBalancerListeners * @see AWS API Documentation */ java.util.concurrent.Future* Creates one or more listeners for the specified load balancer. If a listener with the specified port does not * already exist, it is created; otherwise, the properties of the new listener must match the properties of the * existing listener. *
** For more information, see Listeners for * Your Classic Load Balancer in the Classic Load Balancers Guide. *
* * @param createLoadBalancerListenersRequest * Contains the parameters for CreateLoadBalancerListeners. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateLoadBalancerListeners operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.CreateLoadBalancerListeners * @see AWS API Documentation */ java.util.concurrent.Future* Creates a policy with the specified attributes for the specified load balancer. *
** Policies are settings that are saved for your load balancer and that can be applied to the listener or the * application server, depending on the policy type. *
* * @param createLoadBalancerPolicyRequest * Contains the parameters for CreateLoadBalancerPolicy. * @return A Java Future containing the result of the CreateLoadBalancerPolicy operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.CreateLoadBalancerPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Creates a policy with the specified attributes for the specified load balancer. *
** Policies are settings that are saved for your load balancer and that can be applied to the listener or the * application server, depending on the policy type. *
* * @param createLoadBalancerPolicyRequest * Contains the parameters for CreateLoadBalancerPolicy. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateLoadBalancerPolicy operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.CreateLoadBalancerPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Deletes the specified load balancer. *
** If you are attempting to recreate a load balancer, you must reconfigure all settings. The DNS name associated * with a deleted load balancer are no longer usable. The name and associated DNS record of the deleted load * balancer no longer exist and traffic sent to any of its IP addresses is no longer delivered to your instances. *
*
* If the load balancer does not exist or has already been deleted, the call to DeleteLoadBalancer
* still succeeds.
*
* Deletes the specified load balancer. *
** If you are attempting to recreate a load balancer, you must reconfigure all settings. The DNS name associated * with a deleted load balancer are no longer usable. The name and associated DNS record of the deleted load * balancer no longer exist and traffic sent to any of its IP addresses is no longer delivered to your instances. *
*
* If the load balancer does not exist or has already been deleted, the call to DeleteLoadBalancer
* still succeeds.
*
* Deletes the specified listeners from the specified load balancer. *
* * @param deleteLoadBalancerListenersRequest * Contains the parameters for DeleteLoadBalancerListeners. * @return A Java Future containing the result of the DeleteLoadBalancerListeners operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.DeleteLoadBalancerListeners * @see AWS API Documentation */ java.util.concurrent.Future* Deletes the specified listeners from the specified load balancer. *
* * @param deleteLoadBalancerListenersRequest * Contains the parameters for DeleteLoadBalancerListeners. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteLoadBalancerListeners operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.DeleteLoadBalancerListeners * @see AWS API Documentation */ java.util.concurrent.Future* Deletes the specified policy from the specified load balancer. This policy must not be enabled for any listeners. *
* * @param deleteLoadBalancerPolicyRequest * Contains the parameters for DeleteLoadBalancerPolicy. * @return A Java Future containing the result of the DeleteLoadBalancerPolicy operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.DeleteLoadBalancerPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Deletes the specified policy from the specified load balancer. This policy must not be enabled for any listeners. *
* * @param deleteLoadBalancerPolicyRequest * Contains the parameters for DeleteLoadBalancerPolicy. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteLoadBalancerPolicy operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.DeleteLoadBalancerPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Deregisters the specified instances from the specified load balancer. After the instance is deregistered, it no * longer receives traffic from the load balancer. *
** You can use DescribeLoadBalancers to verify that the instance is deregistered from the load balancer. *
** For more information, see Register or De-Register EC2 Instances in the Classic Load Balancers Guide. *
* * @param deregisterInstancesFromLoadBalancerRequest * Contains the parameters for DeregisterInstancesFromLoadBalancer. * @return A Java Future containing the result of the DeregisterInstancesFromLoadBalancer operation returned by the * service. * @sample AmazonElasticLoadBalancingAsync.DeregisterInstancesFromLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Deregisters the specified instances from the specified load balancer. After the instance is deregistered, it no * longer receives traffic from the load balancer. *
** You can use DescribeLoadBalancers to verify that the instance is deregistered from the load balancer. *
** For more information, see Register or De-Register EC2 Instances in the Classic Load Balancers Guide. *
* * @param deregisterInstancesFromLoadBalancerRequest * Contains the parameters for DeregisterInstancesFromLoadBalancer. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeregisterInstancesFromLoadBalancer operation returned by the * service. * @sample AmazonElasticLoadBalancingAsyncHandler.DeregisterInstancesFromLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Describes the current Elastic Load Balancing resource limits for your AWS account. *
** For more information, see Limits for Your Classic * Load Balancer in the Classic Load Balancers Guide. *
* * @param describeAccountLimitsRequest * @return A Java Future containing the result of the DescribeAccountLimits operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.DescribeAccountLimits * @see AWS API Documentation */ java.util.concurrent.Future* Describes the current Elastic Load Balancing resource limits for your AWS account. *
** For more information, see Limits for Your Classic * Load Balancer in the Classic Load Balancers Guide. *
* * @param describeAccountLimitsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeAccountLimits operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.DescribeAccountLimits * @see AWS API Documentation */ java.util.concurrent.Future* Describes the state of the specified instances with respect to the specified load balancer. If no instances are * specified, the call describes the state of all instances that are currently registered with the load balancer. If * instances are specified, their state is returned even if they are no longer registered with the load balancer. * The state of terminated instances is not returned. *
* * @param describeInstanceHealthRequest * Contains the parameters for DescribeInstanceHealth. * @return A Java Future containing the result of the DescribeInstanceHealth operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.DescribeInstanceHealth * @see AWS API Documentation */ java.util.concurrent.Future* Describes the state of the specified instances with respect to the specified load balancer. If no instances are * specified, the call describes the state of all instances that are currently registered with the load balancer. If * instances are specified, their state is returned even if they are no longer registered with the load balancer. * The state of terminated instances is not returned. *
* * @param describeInstanceHealthRequest * Contains the parameters for DescribeInstanceHealth. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeInstanceHealth operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.DescribeInstanceHealth * @see AWS API Documentation */ java.util.concurrent.Future* Describes the attributes for the specified load balancer. *
* * @param describeLoadBalancerAttributesRequest * Contains the parameters for DescribeLoadBalancerAttributes. * @return A Java Future containing the result of the DescribeLoadBalancerAttributes operation returned by the * service. * @sample AmazonElasticLoadBalancingAsync.DescribeLoadBalancerAttributes * @see AWS API Documentation */ java.util.concurrent.Future* Describes the attributes for the specified load balancer. *
* * @param describeLoadBalancerAttributesRequest * Contains the parameters for DescribeLoadBalancerAttributes. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeLoadBalancerAttributes operation returned by the * service. * @sample AmazonElasticLoadBalancingAsyncHandler.DescribeLoadBalancerAttributes * @see AWS API Documentation */ java.util.concurrent.Future* Describes the specified policies. *
*
* If you specify a load balancer name, the action returns the descriptions of all policies created for the load
* balancer. If you specify a policy name associated with your load balancer, the action returns the description of
* that policy. If you don't specify a load balancer name, the action returns descriptions of the specified sample
* policies, or descriptions of all sample policies. The names of the sample policies have the
* ELBSample-
prefix.
*
* Describes the specified policies. *
*
* If you specify a load balancer name, the action returns the descriptions of all policies created for the load
* balancer. If you specify a policy name associated with your load balancer, the action returns the description of
* that policy. If you don't specify a load balancer name, the action returns descriptions of the specified sample
* policies, or descriptions of all sample policies. The names of the sample policies have the
* ELBSample-
prefix.
*
* Describes the specified load balancer policy types or all load balancer policy types. *
** The description of each type indicates how it can be used. For example, some policies can be used only with layer * 7 listeners, some policies can be used only with layer 4 listeners, and some policies can be used only with your * EC2 instances. *
** You can use CreateLoadBalancerPolicy to create a policy configuration for any of these policy types. Then, * depending on the policy type, use either SetLoadBalancerPoliciesOfListener or * SetLoadBalancerPoliciesForBackendServer to set the policy. *
* * @param describeLoadBalancerPolicyTypesRequest * Contains the parameters for DescribeLoadBalancerPolicyTypes. * @return A Java Future containing the result of the DescribeLoadBalancerPolicyTypes operation returned by the * service. * @sample AmazonElasticLoadBalancingAsync.DescribeLoadBalancerPolicyTypes * @see AWS API Documentation */ java.util.concurrent.Future* Describes the specified load balancer policy types or all load balancer policy types. *
** The description of each type indicates how it can be used. For example, some policies can be used only with layer * 7 listeners, some policies can be used only with layer 4 listeners, and some policies can be used only with your * EC2 instances. *
** You can use CreateLoadBalancerPolicy to create a policy configuration for any of these policy types. Then, * depending on the policy type, use either SetLoadBalancerPoliciesOfListener or * SetLoadBalancerPoliciesForBackendServer to set the policy. *
* * @param describeLoadBalancerPolicyTypesRequest * Contains the parameters for DescribeLoadBalancerPolicyTypes. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeLoadBalancerPolicyTypes operation returned by the * service. * @sample AmazonElasticLoadBalancingAsyncHandler.DescribeLoadBalancerPolicyTypes * @see AWS API Documentation */ java.util.concurrent.Future* Describes the specified the load balancers. If no load balancers are specified, the call describes all of your * load balancers. *
* * @param describeLoadBalancersRequest * Contains the parameters for DescribeLoadBalancers. * @return A Java Future containing the result of the DescribeLoadBalancers operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.DescribeLoadBalancers * @see AWS API Documentation */ java.util.concurrent.Future* Describes the specified the load balancers. If no load balancers are specified, the call describes all of your * load balancers. *
* * @param describeLoadBalancersRequest * Contains the parameters for DescribeLoadBalancers. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeLoadBalancers operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.DescribeLoadBalancers * @see AWS API Documentation */ java.util.concurrent.Future* Describes the tags associated with the specified load balancers. *
* * @param describeTagsRequest * Contains the parameters for DescribeTags. * @return A Java Future containing the result of the DescribeTags operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.DescribeTags * @see AWS API Documentation */ java.util.concurrent.Future* Describes the tags associated with the specified load balancers. *
* * @param describeTagsRequest * Contains the parameters for DescribeTags. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeTags operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.DescribeTags * @see AWS API Documentation */ java.util.concurrent.Future* Removes the specified subnets from the set of configured subnets for the load balancer. *
*
* After a subnet is removed, all EC2 instances registered with the load balancer in the removed subnet go into the
* OutOfService
state. Then, the load balancer balances the traffic among the remaining routable
* subnets.
*
* Removes the specified subnets from the set of configured subnets for the load balancer. *
*
* After a subnet is removed, all EC2 instances registered with the load balancer in the removed subnet go into the
* OutOfService
state. Then, the load balancer balances the traffic among the remaining routable
* subnets.
*
* Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer in * EC2-Classic or a default VPC. *
** For load balancers in a non-default VPC, use DetachLoadBalancerFromSubnets. *
*
* There must be at least one Availability Zone registered with a load balancer at all times. After an Availability
* Zone is removed, all instances registered with the load balancer that are in the removed Availability Zone go
* into the OutOfService
state. Then, the load balancer attempts to equally balance the traffic among
* its remaining Availability Zones.
*
* For more information, see Add or Remove * Availability Zones in the Classic Load Balancers Guide. *
* * @param disableAvailabilityZonesForLoadBalancerRequest * Contains the parameters for DisableAvailabilityZonesForLoadBalancer. * @return A Java Future containing the result of the DisableAvailabilityZonesForLoadBalancer operation returned by * the service. * @sample AmazonElasticLoadBalancingAsync.DisableAvailabilityZonesForLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer in * EC2-Classic or a default VPC. *
** For load balancers in a non-default VPC, use DetachLoadBalancerFromSubnets. *
*
* There must be at least one Availability Zone registered with a load balancer at all times. After an Availability
* Zone is removed, all instances registered with the load balancer that are in the removed Availability Zone go
* into the OutOfService
state. Then, the load balancer attempts to equally balance the traffic among
* its remaining Availability Zones.
*
* For more information, see Add or Remove * Availability Zones in the Classic Load Balancers Guide. *
* * @param disableAvailabilityZonesForLoadBalancerRequest * Contains the parameters for DisableAvailabilityZonesForLoadBalancer. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisableAvailabilityZonesForLoadBalancer operation returned by * the service. * @sample AmazonElasticLoadBalancingAsyncHandler.DisableAvailabilityZonesForLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Adds the specified Availability Zones to the set of Availability Zones for the specified load balancer in * EC2-Classic or a default VPC. *
** For load balancers in a non-default VPC, use AttachLoadBalancerToSubnets. *
** The load balancer evenly distributes requests across all its registered Availability Zones that contain * instances. For more information, see Add or Remove * Availability Zones in the Classic Load Balancers Guide. *
* * @param enableAvailabilityZonesForLoadBalancerRequest * Contains the parameters for EnableAvailabilityZonesForLoadBalancer. * @return A Java Future containing the result of the EnableAvailabilityZonesForLoadBalancer operation returned by * the service. * @sample AmazonElasticLoadBalancingAsync.EnableAvailabilityZonesForLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Adds the specified Availability Zones to the set of Availability Zones for the specified load balancer in * EC2-Classic or a default VPC. *
** For load balancers in a non-default VPC, use AttachLoadBalancerToSubnets. *
** The load balancer evenly distributes requests across all its registered Availability Zones that contain * instances. For more information, see Add or Remove * Availability Zones in the Classic Load Balancers Guide. *
* * @param enableAvailabilityZonesForLoadBalancerRequest * Contains the parameters for EnableAvailabilityZonesForLoadBalancer. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the EnableAvailabilityZonesForLoadBalancer operation returned by * the service. * @sample AmazonElasticLoadBalancingAsyncHandler.EnableAvailabilityZonesForLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Modifies the attributes of the specified load balancer. *
*
* You can modify the load balancer attributes, such as AccessLogs
, ConnectionDraining
,
* and CrossZoneLoadBalancing
by either enabling or disabling them. Or, you can modify the load
* balancer attribute ConnectionSettings
by specifying an idle connection timeout value for your load
* balancer.
*
* For more information, see the following in the Classic Load Balancers Guide: *
** Access * Logs *
** Modifies the attributes of the specified load balancer. *
*
* You can modify the load balancer attributes, such as AccessLogs
, ConnectionDraining
,
* and CrossZoneLoadBalancing
by either enabling or disabling them. Or, you can modify the load
* balancer attribute ConnectionSettings
by specifying an idle connection timeout value for your load
* balancer.
*
* For more information, see the following in the Classic Load Balancers Guide: *
** Access * Logs *
** 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.
*
* To deregister instances from a load balancer, use DeregisterInstancesFromLoadBalancer. *
** For more information, see Register or De-Register EC2 Instances in the Classic Load Balancers Guide. *
* * @param registerInstancesWithLoadBalancerRequest * Contains the parameters for RegisterInstancesWithLoadBalancer. * @return A Java Future containing the result of the RegisterInstancesWithLoadBalancer operation returned by the * service. * @sample AmazonElasticLoadBalancingAsync.RegisterInstancesWithLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* 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.
*
* To deregister instances from a load balancer, use DeregisterInstancesFromLoadBalancer. *
** For more information, see Register or De-Register EC2 Instances in the Classic Load Balancers Guide. *
* * @param registerInstancesWithLoadBalancerRequest * Contains the parameters for RegisterInstancesWithLoadBalancer. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RegisterInstancesWithLoadBalancer operation returned by the * service. * @sample AmazonElasticLoadBalancingAsyncHandler.RegisterInstancesWithLoadBalancer * @see AWS API Documentation */ java.util.concurrent.Future* Removes one or more tags from the specified load balancer. *
* * @param removeTagsRequest * Contains the parameters for RemoveTags. * @return A Java Future containing the result of the RemoveTags operation returned by the service. * @sample AmazonElasticLoadBalancingAsync.RemoveTags * @see AWS API Documentation */ java.util.concurrent.Future* Removes one or more tags from the specified load balancer. *
* * @param removeTagsRequest * Contains the parameters for RemoveTags. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RemoveTags operation returned by the service. * @sample AmazonElasticLoadBalancingAsyncHandler.RemoveTags * @see AWS API Documentation */ java.util.concurrent.Future* Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces * any prior certificate that was used on the same load balancer and port. *
** For more information about updating your SSL certificate, see Replace the SSL * Certificate for Your Load Balancer in the Classic Load Balancers Guide. *
* * @param setLoadBalancerListenerSSLCertificateRequest * Contains the parameters for SetLoadBalancerListenerSSLCertificate. * @return A Java Future containing the result of the SetLoadBalancerListenerSSLCertificate operation returned by * the service. * @sample AmazonElasticLoadBalancingAsync.SetLoadBalancerListenerSSLCertificate * @see AWS API Documentation */ java.util.concurrent.Future* Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces * any prior certificate that was used on the same load balancer and port. *
** For more information about updating your SSL certificate, see Replace the SSL * Certificate for Your Load Balancer in the Classic Load Balancers Guide. *
* * @param setLoadBalancerListenerSSLCertificateRequest * Contains the parameters for SetLoadBalancerListenerSSLCertificate. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the SetLoadBalancerListenerSSLCertificate operation returned by * the service. * @sample AmazonElasticLoadBalancingAsyncHandler.SetLoadBalancerListenerSSLCertificate * @see AWS API Documentation */ java.util.concurrent.Future* Replaces the set of policies associated with the specified port on which the EC2 instance is listening with a new * set of policies. At this time, only the back-end server authentication policy type can be applied to the instance * ports; this policy type is composed of multiple public key policies. *
*
* Each time you use SetLoadBalancerPoliciesForBackendServer
to enable the policies, use the
* PolicyNames
parameter to list the policies that you want to enable.
*
* You can use DescribeLoadBalancers or DescribeLoadBalancerPolicies to verify that the policy is * associated with the EC2 instance. *
** For more information about enabling back-end instance authentication, see Configure Back-end Instance Authentication in the Classic Load Balancers Guide. For more information * about Proxy Protocol, see Configure Proxy * Protocol Support in the Classic Load Balancers Guide. *
* * @param setLoadBalancerPoliciesForBackendServerRequest * Contains the parameters for SetLoadBalancerPoliciesForBackendServer. * @return A Java Future containing the result of the SetLoadBalancerPoliciesForBackendServer operation returned by * the service. * @sample AmazonElasticLoadBalancingAsync.SetLoadBalancerPoliciesForBackendServer * @see AWS API Documentation */ java.util.concurrent.Future* Replaces the set of policies associated with the specified port on which the EC2 instance is listening with a new * set of policies. At this time, only the back-end server authentication policy type can be applied to the instance * ports; this policy type is composed of multiple public key policies. *
*
* Each time you use SetLoadBalancerPoliciesForBackendServer
to enable the policies, use the
* PolicyNames
parameter to list the policies that you want to enable.
*
* You can use DescribeLoadBalancers or DescribeLoadBalancerPolicies to verify that the policy is * associated with the EC2 instance. *
** For more information about enabling back-end instance authentication, see Configure Back-end Instance Authentication in the Classic Load Balancers Guide. For more information * about Proxy Protocol, see Configure Proxy * Protocol Support in the Classic Load Balancers Guide. *
* * @param setLoadBalancerPoliciesForBackendServerRequest * Contains the parameters for SetLoadBalancerPoliciesForBackendServer. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the SetLoadBalancerPoliciesForBackendServer operation returned by * the service. * @sample AmazonElasticLoadBalancingAsyncHandler.SetLoadBalancerPoliciesForBackendServer * @see AWS API Documentation */ java.util.concurrent.Future* Replaces the current set of policies for the specified load balancer port with the specified set of policies. *
** To enable back-end server authentication, use SetLoadBalancerPoliciesForBackendServer. *
** For more information about setting policies, see Update the SSL * Negotiation Configuration, Duration-Based Session Stickiness, and Application-Controlled Session Stickiness in the Classic Load Balancers Guide. *
* * @param setLoadBalancerPoliciesOfListenerRequest * Contains the parameters for SetLoadBalancePoliciesOfListener. * @return A Java Future containing the result of the SetLoadBalancerPoliciesOfListener operation returned by the * service. * @sample AmazonElasticLoadBalancingAsync.SetLoadBalancerPoliciesOfListener * @see AWS API Documentation */ java.util.concurrent.Future* Replaces the current set of policies for the specified load balancer port with the specified set of policies. *
** To enable back-end server authentication, use SetLoadBalancerPoliciesForBackendServer. *
** For more information about setting policies, see Update the SSL * Negotiation Configuration, Duration-Based Session Stickiness, and Application-Controlled Session Stickiness in the Classic Load Balancers Guide. *
* * @param setLoadBalancerPoliciesOfListenerRequest * Contains the parameters for SetLoadBalancePoliciesOfListener. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the SetLoadBalancerPoliciesOfListener operation returned by the * service. * @sample AmazonElasticLoadBalancingAsyncHandler.SetLoadBalancerPoliciesOfListener * @see AWS API Documentation */ java.util.concurrent.Future