AmazonElasticLoadBalancing (AWS SDK for Java

All Known Subinterfaces:

AmazonElasticLoadBalancingAsync

All Known Implementing Classes:

AbstractAmazonElasticLoadBalancing, AbstractAmazonElasticLoadBalancingAsync, AmazonElasticLoadBalancingAsyncClient, AmazonElasticLoadBalancingClient
```
@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AmazonElasticLoadBalancing
```
Interface for accessing Elastic Load Balancing v2.
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAmazonElasticLoadBalancing instead.

Elastic Load Balancing
A load balancer distributes incoming traffic across targets, such as your EC2 instances. This enables you to increase the availability of your application. The load balancer also monitors the health of its registered targets and ensures that it routes traffic only to healthy targets. 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. You configure a target group with a protocol and port number for connections from the load balancer to the targets, and with health check settings to be used when checking the health status of the targets.

Elastic Load Balancing supports the following types of load balancers: Application Load Balancers, Network Load Balancers, and Classic Load Balancers.

An Application Load Balancer makes routing and load balancing decisions at the application layer (HTTP/HTTPS). A Network Load Balancer makes routing and load balancing decisions at the transport layer (TCP). Both Application Load Balancers and Network Load Balancers can route requests to one or more ports on each EC2 instance or container instance in your virtual private cloud (VPC).

A Classic Load Balancer makes routing and load balancing decisions either at the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS), and supports either EC2-Classic or a VPC. For more information, see the Elastic Load Balancing User Guide.

This reference covers the 2015-12-01 API, which supports Application Load Balancers and Network Load Balancers. The 2012-06-01 API supports Classic Load Balancers.

To get started, complete the following tasks:
1. Create a load balancer using CreateLoadBalancer.
2. Create a target group using CreateTargetGroup.
3. Register targets for the target group using RegisterTargets.
4. Create one or more listeners for your load balancer using CreateListener.
To delete a load balancer and its related resources, complete the following tasks:
1. Delete the load balancer using DeleteLoadBalancer.
2. Delete the target group using DeleteTargetGroup.
All Elastic Load Balancing operations are idempotent, which means that they complete at most one time. If you repeat an operation, it succeeds.

Field Summary

Fields
Modifier and Type Field and Description

static String ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.

Fields
Modifier and Type	Field and Description
`static String`	`ENDPOINT_PREFIX` The region metadata service name for computing region endpoints.

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`AddListenerCertificatesResult`	`addListenerCertificates(AddListenerCertificatesRequest addListenerCertificatesRequest)` Adds the specified certificate to the specified secure listener.
`AddTagsResult`	`addTags(AddTagsRequest addTagsRequest)` Adds the specified tags to the specified Elastic Load Balancing resource.
`CreateListenerResult`	`createListener(CreateListenerRequest createListenerRequest)` Creates a listener for the specified Application Load Balancer or Network Load Balancer.
`CreateLoadBalancerResult`	`createLoadBalancer(CreateLoadBalancerRequest createLoadBalancerRequest)` Creates an Application Load Balancer or a Network Load Balancer.
`CreateRuleResult`	`createRule(CreateRuleRequest createRuleRequest)` Creates a rule for the specified listener.
`CreateTargetGroupResult`	`createTargetGroup(CreateTargetGroupRequest createTargetGroupRequest)` Creates a target group.
`DeleteListenerResult`	`deleteListener(DeleteListenerRequest deleteListenerRequest)` Deletes the specified listener.
`DeleteLoadBalancerResult`	`deleteLoadBalancer(DeleteLoadBalancerRequest deleteLoadBalancerRequest)` Deletes the specified Application Load Balancer or Network Load Balancer and its attached listeners.
`DeleteRuleResult`	`deleteRule(DeleteRuleRequest deleteRuleRequest)` Deletes the specified rule.
`DeleteTargetGroupResult`	`deleteTargetGroup(DeleteTargetGroupRequest deleteTargetGroupRequest)` Deletes the specified target group.
`DeregisterTargetsResult`	`deregisterTargets(DeregisterTargetsRequest deregisterTargetsRequest)` Deregisters the specified targets from the specified target group.
`DescribeAccountLimitsResult`	`describeAccountLimits(DescribeAccountLimitsRequest describeAccountLimitsRequest)` Describes the current Elastic Load Balancing resource limits for your AWS account.
`DescribeListenerCertificatesResult`	`describeListenerCertificates(DescribeListenerCertificatesRequest describeListenerCertificatesRequest)` Describes the certificates for the specified secure listener.
`DescribeListenersResult`	`describeListeners(DescribeListenersRequest describeListenersRequest)` Describes the specified listeners or the listeners for the specified Application Load Balancer or Network Load Balancer.
`DescribeLoadBalancerAttributesResult`	`describeLoadBalancerAttributes(DescribeLoadBalancerAttributesRequest describeLoadBalancerAttributesRequest)` Describes the attributes for the specified Application Load Balancer or Network Load Balancer.
`DescribeLoadBalancersResult`	`describeLoadBalancers(DescribeLoadBalancersRequest describeLoadBalancersRequest)` Describes the specified load balancers or all of your load balancers.
`DescribeRulesResult`	`describeRules(DescribeRulesRequest describeRulesRequest)` Describes the specified rules or the rules for the specified listener.
`DescribeSSLPoliciesResult`	`describeSSLPolicies(DescribeSSLPoliciesRequest describeSSLPoliciesRequest)` Describes the specified policies or all policies used for SSL negotiation.
`DescribeTagsResult`	`describeTags(DescribeTagsRequest describeTagsRequest)` Describes the tags for the specified resources.
`DescribeTargetGroupAttributesResult`	`describeTargetGroupAttributes(DescribeTargetGroupAttributesRequest describeTargetGroupAttributesRequest)` Describes the attributes for the specified target group.
`DescribeTargetGroupsResult`	`describeTargetGroups(DescribeTargetGroupsRequest describeTargetGroupsRequest)` Describes the specified target groups or all of your target groups.
`DescribeTargetHealthResult`	`describeTargetHealth(DescribeTargetHealthRequest describeTargetHealthRequest)` Describes the health of the specified targets or all of your targets.
`ResponseMetadata`	`getCachedResponseMetadata(AmazonWebServiceRequest request)` Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected.
`ModifyListenerResult`	`modifyListener(ModifyListenerRequest modifyListenerRequest)` Modifies the specified properties of the specified listener.
`ModifyLoadBalancerAttributesResult`	`modifyLoadBalancerAttributes(ModifyLoadBalancerAttributesRequest modifyLoadBalancerAttributesRequest)` Modifies the specified attributes of the specified Application Load Balancer or Network Load Balancer.
`ModifyRuleResult`	`modifyRule(ModifyRuleRequest modifyRuleRequest)` Modifies the specified rule.
`ModifyTargetGroupResult`	`modifyTargetGroup(ModifyTargetGroupRequest modifyTargetGroupRequest)` Modifies the health checks used when evaluating the health state of the targets in the specified target group.
`ModifyTargetGroupAttributesResult`	`modifyTargetGroupAttributes(ModifyTargetGroupAttributesRequest modifyTargetGroupAttributesRequest)` Modifies the specified attributes of the specified target group.
`RegisterTargetsResult`	`registerTargets(RegisterTargetsRequest registerTargetsRequest)` Registers the specified targets with the specified target group.
`RemoveListenerCertificatesResult`	`removeListenerCertificates(RemoveListenerCertificatesRequest removeListenerCertificatesRequest)` Removes the specified certificate from the specified secure listener.
`RemoveTagsResult`	`removeTags(RemoveTagsRequest removeTagsRequest)` Removes the specified tags from the specified Elastic Load Balancing resource.
`void`	`setEndpoint(String endpoint)` Deprecated. use `AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)` for example: `builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));`
`SetIpAddressTypeResult`	`setIpAddressType(SetIpAddressTypeRequest setIpAddressTypeRequest)` Sets the type of IP addresses used by the subnets of the specified Application Load Balancer or Network Load Balancer.
`void`	`setRegion(Region region)` Deprecated. use `AwsClientBuilder#setRegion(String)`
`SetRulePrioritiesResult`	`setRulePriorities(SetRulePrioritiesRequest setRulePrioritiesRequest)` Sets the priorities of the specified rules.
`SetSecurityGroupsResult`	`setSecurityGroups(SetSecurityGroupsRequest setSecurityGroupsRequest)` Associates the specified security groups with the specified Application Load Balancer.
`SetSubnetsResult`	`setSubnets(SetSubnetsRequest setSubnetsRequest)` Enables the Availability Zone for the specified subnets for the specified Application Load Balancer.
`void`	`shutdown()` Shuts down this client object, releasing any resources that might be held open.
`AmazonElasticLoadBalancingWaiters`	`waiters()`

- Field Detail
  - ENDPOINT_PREFIX
```
static final String ENDPOINT_PREFIX
```
    The region metadata service name for computing region endpoints. You can use this value to retrieve metadata (such as supported regions) of the service.
    
    See Also:
    
    RegionUtils.getRegionsForService(String), Constant Field Values
- Method Detail
  - setEndpoint
```
@Deprecated
void setEndpoint(String endpoint)
```
    Deprecated. use AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration) for example: builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));
    
    Overrides the default endpoint for this client ("elasticloadbalancing.us-east-1.amazonaws.com"). Callers can use this method to control which AWS region they want to work with.
    Callers can pass in just the endpoint (ex: "elasticloadbalancing.us-east-1.amazonaws.com") or a full URL, including the protocol (ex: "elasticloadbalancing.us-east-1.amazonaws.com"). If the protocol is not specified here, the default protocol from this client's ClientConfiguration will be used, which by default is HTTPS.
    For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912
    This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
    
    Parameters:
    
    endpoint - The endpoint (ex: "elasticloadbalancing.us-east-1.amazonaws.com") or a full URL, including the protocol (ex: "elasticloadbalancing.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will communicate with.
  - setRegion
```
@Deprecated
void setRegion(Region region)
```
    Deprecated. use AwsClientBuilder#setRegion(String)
    
    An alternative to setEndpoint(String), sets the regional endpoint for this client's service calls. Callers can use this method to control which AWS region they want to work with.
    By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the ClientConfiguration supplied at construction.
    This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
    
    Parameters:
    
    region - The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions) for accessing a given region. Must not be null and must be a region where the service is available.
    
    See Also:
    
    Region.getRegion(com.amazonaws.regions.Regions), Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration), Region.isServiceSupported(String)
  - addListenerCertificates
```
AddListenerCertificatesResult addListenerCertificates(AddListenerCertificatesRequest addListenerCertificatesRequest)
```
    Adds the specified certificate to the specified secure listener.
    
    If the certificate was already added, the call is successful but the certificate is not added again.
    
    To list the certificates for your listener, use DescribeListenerCertificates. To remove certificates from your listener, use RemoveListenerCertificates.
    
    Parameters:
    
    addListenerCertificatesRequest -
    
    Returns:
    
    Result of the AddListenerCertificates operation returned by the service.
    
    Throws:
    
    ListenerNotFoundException - The specified listener does not exist.
    
    TooManyCertificatesException - You've reached the limit on the number of certificates per load balancer.
    
    CertificateNotFoundException - The specified certificate does not exist.
    
    See Also:
    
    AWS API Documentation
  - addTags
```
AddTagsResult addTags(AddTagsRequest addTagsRequest)
```
    Adds the specified tags to the specified Elastic Load Balancing resource. You can tag your Application Load Balancers, Network Load Balancers, and your target groups.
    
    Each tag consists of a key and an optional value. If a resource already has a tag with the same key, AddTags updates its value.
    
    To list the current tags for your resources, use DescribeTags. To remove tags from your resources, use RemoveTags.
    Parameters:
    
    addTagsRequest -
    
    Returns:
    
    Result of the AddTags operation returned by the service.
    
    Throws:
    
    DuplicateTagKeysException - A tag key was specified more than once.
    
    TooManyTagsException - You've reached the limit on the number of tags per load balancer.
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To add tags to a load balancer
      This example adds the specified tags to the specified load balancer.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); AddTagsRequest request = new AddTagsRequest() .withResourceArns( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188") .withTags( new Tag().withKey("project").withValue("lima"), new Tag().withKey("department").withValue( "digital-media")); AddTagsResult response = client.addTags(request);
  - createListener
```
CreateListenerResult createListener(CreateListenerRequest createListenerRequest)
```
    Creates a listener for the specified Application Load Balancer or Network Load Balancer.
    
    To update a listener, use ModifyListener. When you are finished with a listener, you can delete it using DeleteListener. If you are finished with both the listener and the load balancer, you can delete them both using DeleteLoadBalancer.
    
    This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple listeners with the same settings, each call succeeds.
    
    For more information, see Listeners for Your Application Load Balancers in the Application Load Balancers Guide and Listeners for Your Network Load Balancers in the Network Load Balancers Guide.
    Parameters:
    
    createListenerRequest -
    
    Returns:
    
    Result of the CreateListener operation returned by the service.
    
    Throws:
    
    DuplicateListenerException - A listener with the specified port already exists.
    
    TooManyListenersException - You've reached the limit on the number of listeners per load balancer.
    
    TooManyCertificatesException - You've reached the limit on the number of certificates per load balancer.
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    TargetGroupAssociationLimitException - You've reached the limit on the number of load balancers per target group.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    IncompatibleProtocolsException - The specified configuration is not valid with this protocol.
    
    SSLPolicyNotFoundException - The specified SSL policy does not exist.
    
    CertificateNotFoundException - The specified certificate does not exist.
    
    UnsupportedProtocolException - The specified protocol is not supported.
    
    TooManyRegistrationsForTargetIdException - You've reached the limit on the number of times a target can be registered with a load balancer.
    
    TooManyTargetsException - You've reached the limit on the number of targets.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To create an HTTPS listener
      This example creates an HTTPS listener for the specified load balancer that forwards requests to the specified target group. Note that you must specify an SSL certificate for an HTTPS listener. You can create and manage certificates using AWS Certificate Manager (ACM). Alternatively, you can create a certificate using SSL/TLS tools, get the certificate signed by a certificate authority (CA), and upload the certificate to AWS Identity and Access Management (IAM).
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); CreateListenerRequest request = new CreateListenerRequest() .withDefaultActions( new Action() .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067") .withType("forward")) .withLoadBalancerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188") .withPort(80).withProtocol("HTTP"); CreateListenerResult response = client.createListener(request);AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); CreateListenerRequest request = new CreateListenerRequest() .withCertificates( new Certificate() .withCertificateArn("arn:aws:iam::123456789012:server-certificate/my-server-cert")) .withDefaultActions( new Action() .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067") .withType("forward")) .withLoadBalancerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188") .withPort(443).withProtocol("HTTPS") .withSslPolicy("ELBSecurityPolicy-2015-05"); CreateListenerResult response = client.createListener(request);
  - createLoadBalancer
```
CreateLoadBalancerResult createLoadBalancer(CreateLoadBalancerRequest createLoadBalancerRequest)
```
    Creates an Application Load Balancer or a Network Load Balancer.
    
    When you create a load balancer, you can specify security groups, subnets, IP address type, and tags. Otherwise, you could do so later using SetSecurityGroups, SetSubnets, SetIpAddressType, and AddTags.
    
    To create listeners for your load balancer, use CreateListener. To describe your current load balancers, see DescribeLoadBalancers. When you are finished with a load balancer, you can delete it using DeleteLoadBalancer.
    
    For limit information, see Limits for Your Application Load Balancer in the Application Load Balancers Guide and Limits for Your Network Load Balancer in the Network Load Balancers Guide.
    
    This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple load balancers with the same settings, each call succeeds.
    
    For more information, see Application Load Balancers in the Application Load Balancers Guide and Network Load Balancers in the Network Load Balancers Guide.
    Parameters:
    
    createLoadBalancerRequest -
    
    Returns:
    
    Result of the CreateLoadBalancer operation returned by the service.
    
    Throws:
    
    DuplicateLoadBalancerNameException - A load balancer with the specified name already exists.
    
    TooManyLoadBalancersException - You've reached the limit on the number of load balancers for your AWS account.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    SubnetNotFoundException - The specified subnet does not exist.
    
    InvalidSubnetException - The specified subnet is out of available addresses.
    
    InvalidSecurityGroupException - The specified security group does not exist.
    
    InvalidSchemeException - The requested scheme is not valid.
    
    TooManyTagsException - You've reached the limit on the number of tags per load balancer.
    
    DuplicateTagKeysException - A tag key was specified more than once.
    
    ResourceInUseException - A specified resource is in use.
    
    AllocationIdNotFoundException - The specified allocation ID does not exist.
    
    AvailabilityZoneNotSupportedException - The specified Availability Zone is not supported.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To create an internal load balancer
      This example creates an internal load balancer and enables the Availability Zones for the specified subnets.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); CreateLoadBalancerRequest request = new CreateLoadBalancerRequest() .withName("my-load-balancer").withSubnets("subnet-b7d581c0", "subnet-8360a9e7"); CreateLoadBalancerResult response = client.createLoadBalancer(request);AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); CreateLoadBalancerRequest request = new CreateLoadBalancerRequest() .withName("my-internal-load-balancer").withScheme("internal") .withSecurityGroups() .withSubnets("subnet-b7d581c0", "subnet-8360a9e7"); CreateLoadBalancerResult response = client.createLoadBalancer(request);
  - createRule
```
CreateRuleResult createRule(CreateRuleRequest createRuleRequest)
```
    Creates a rule for the specified listener. The listener must be associated with an Application Load Balancer.
    
    Rules are evaluated in priority order, from the lowest value to the highest value. When the condition for a rule is met, the specified action is taken. If no conditions are met, the action for the default rule is taken. For more information, see Listener Rules in the Application Load Balancers Guide.
    
    To view your current rules, use DescribeRules. To update a rule, use ModifyRule. To set the priorities of your rules, use SetRulePriorities. To delete a rule, use DeleteRule.
    Parameters:
    
    createRuleRequest -
    
    Returns:
    
    Result of the CreateRule operation returned by the service.
    
    Throws:
    
    PriorityInUseException - The specified priority is in use.
    
    TooManyTargetGroupsException - You've reached the limit on the number of target groups for your AWS account.
    
    TooManyRulesException - You've reached the limit on the number of rules per load balancer.
    
    TargetGroupAssociationLimitException - You've reached the limit on the number of load balancers per target group.
    
    IncompatibleProtocolsException - The specified configuration is not valid with this protocol.
    
    ListenerNotFoundException - The specified listener does not exist.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    TooManyRegistrationsForTargetIdException - You've reached the limit on the number of times a target can be registered with a load balancer.
    
    TooManyTargetsException - You've reached the limit on the number of targets.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To create a rule
      This example creates a rule that forwards requests to the specified target group if the URL contains the specified pattern (for example, /img/*).
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); CreateRuleRequest request = new CreateRuleRequest() .withActions( new Action() .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067") .withType("forward")) .withConditions( new RuleCondition().withField("path-pattern") .withValues("/img/*")) .withListenerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2") .withPriority(10); CreateRuleResult response = client.createRule(request);
  - createTargetGroup
```
CreateTargetGroupResult createTargetGroup(CreateTargetGroupRequest createTargetGroupRequest)
```
    Creates a target group.
    
    To register targets with the target group, use RegisterTargets. To update the health check settings for the target group, use ModifyTargetGroup. To monitor the health of targets in the target group, use DescribeTargetHealth.
    
    To route traffic to the targets in a target group, specify the target group in an action using CreateListener or CreateRule.
    
    To delete a target group, use DeleteTargetGroup.
    
    This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple target groups with the same settings, each call succeeds.
    
    For more information, see Target Groups for Your Application Load Balancers in the Application Load Balancers Guide or Target Groups for Your Network Load Balancers in the Network Load Balancers Guide.
    Parameters:
    
    createTargetGroupRequest -
    
    Returns:
    
    Result of the CreateTargetGroup operation returned by the service.
    
    Throws:
    
    DuplicateTargetGroupNameException - A target group with the specified name already exists.
    
    TooManyTargetGroupsException - You've reached the limit on the number of target groups for your AWS account.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To create a target group
      This example creates a target group that you can use to route traffic to targets using HTTP on port 80. This target group uses the default health check configuration.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); CreateTargetGroupRequest request = new CreateTargetGroupRequest() .withName("my-targets").withPort(80).withProtocol("HTTP") .withVpcId("vpc-3ac0fb5f"); CreateTargetGroupResult response = client.createTargetGroup(request);
  - deleteListener
```
DeleteListenerResult deleteListener(DeleteListenerRequest deleteListenerRequest)
```
    Deletes the specified listener.
    
    Alternatively, your listener is deleted when you delete the load balancer it is attached to using DeleteLoadBalancer.
    Parameters:
    
    deleteListenerRequest -
    
    Returns:
    
    Result of the DeleteListener operation returned by the service.
    
    Throws:
    
    ListenerNotFoundException - The specified listener does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To delete a listener
      This example deletes the specified listener.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DeleteListenerRequest request = new DeleteListenerRequest() .withListenerArn("arn:aws:elasticloadbalancing:ua-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"); DeleteListenerResult response = client.deleteListener(request);
  - deleteLoadBalancer
```
DeleteLoadBalancerResult deleteLoadBalancer(DeleteLoadBalancerRequest deleteLoadBalancerRequest)
```
    Deletes the specified Application Load Balancer or Network Load Balancer and its attached listeners.
    
    You can't delete a load balancer if deletion protection is enabled. If the load balancer does not exist or has already been deleted, the call succeeds.
    
    Deleting a load balancer does not affect its registered targets. For example, your EC2 instances continue to run and are still registered to their target groups. If you no longer need these EC2 instances, you can stop or terminate them.
    Parameters:
    
    deleteLoadBalancerRequest -
    
    Returns:
    
    Result of the DeleteLoadBalancer operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    OperationNotPermittedException - This operation is not allowed.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To delete a load balancer
      This example deletes the specified load balancer.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DeleteLoadBalancerRequest request = new DeleteLoadBalancerRequest() .withLoadBalancerArn("arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"); DeleteLoadBalancerResult response = client.deleteLoadBalancer(request);
  - deleteRule
```
DeleteRuleResult deleteRule(DeleteRuleRequest deleteRuleRequest)
```
    Deletes the specified rule.
    Parameters:
    
    deleteRuleRequest -
    
    Returns:
    
    Result of the DeleteRule operation returned by the service.
    
    Throws:
    
    RuleNotFoundException - The specified rule does not exist.
    
    OperationNotPermittedException - This operation is not allowed.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To delete a rule
      This example deletes the specified rule.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DeleteRuleRequest request = new DeleteRuleRequest() .withRuleArn("arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3"); DeleteRuleResult response = client.deleteRule(request);
  - deleteTargetGroup
```
DeleteTargetGroupResult deleteTargetGroup(DeleteTargetGroupRequest deleteTargetGroupRequest)
```
    Deletes the specified target group.
    
    You can delete a target group if it is not referenced by any actions. Deleting a target group also deletes any associated health checks.
    Parameters:
    
    deleteTargetGroupRequest -
    
    Returns:
    
    Result of the DeleteTargetGroup operation returned by the service.
    
    Throws:
    
    ResourceInUseException - A specified resource is in use.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To delete a target group
      This example deletes the specified target group.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DeleteTargetGroupRequest request = new DeleteTargetGroupRequest() .withTargetGroupArn("arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"); DeleteTargetGroupResult response = client.deleteTargetGroup(request);
  - deregisterTargets
```
DeregisterTargetsResult deregisterTargets(DeregisterTargetsRequest deregisterTargetsRequest)
```
    Deregisters the specified targets from the specified target group. After the targets are deregistered, they no longer receive traffic from the load balancer.
    Parameters:
    
    deregisterTargetsRequest -
    
    Returns:
    
    Result of the DeregisterTargets operation returned by the service.
    
    Throws:
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    InvalidTargetException - The specified target does not exist, is not in the same VPC as the target group, or has an unsupported instance type.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To deregister a target from a target group
      This example deregisters the specified instance from the specified target group.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DeregisterTargetsRequest request = new DeregisterTargetsRequest() .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067") .withTargets(new TargetDescription().withId("i-0f76fade")); DeregisterTargetsResult response = client.deregisterTargets(request);
  - describeAccountLimits
```
DescribeAccountLimitsResult describeAccountLimits(DescribeAccountLimitsRequest describeAccountLimitsRequest)
```
    Describes the current Elastic Load Balancing resource limits for your AWS account.
    
    For more information, see Limits for Your Application Load Balancers in the Application Load Balancer Guide or Limits for Your Network Load Balancers in the Network Load Balancers Guide.
    
    Parameters:
    
    describeAccountLimitsRequest -
    
    Returns:
    
    Result of the DescribeAccountLimits operation returned by the service.
    
    See Also:
    
    AWS API Documentation
  - describeListenerCertificates
```
DescribeListenerCertificatesResult describeListenerCertificates(DescribeListenerCertificatesRequest describeListenerCertificatesRequest)
```
    Describes the certificates for the specified secure listener.
    
    Parameters:
    
    describeListenerCertificatesRequest -
    
    Returns:
    
    Result of the DescribeListenerCertificates operation returned by the service.
    
    Throws:
    
    ListenerNotFoundException - The specified listener does not exist.
    
    See Also:
    
    AWS API Documentation
  - describeListeners
```
DescribeListenersResult describeListeners(DescribeListenersRequest describeListenersRequest)
```
    Describes the specified listeners or the listeners for the specified Application Load Balancer or Network Load Balancer. You must specify either a load balancer or one or more listeners.
    Parameters:
    
    describeListenersRequest -
    
    Returns:
    
    Result of the DescribeListeners operation returned by the service.
    
    Throws:
    
    ListenerNotFoundException - The specified listener does not exist.
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe a listener
      This example describes the specified listener.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeListenersRequest request = new DescribeListenersRequest() .withListenerArns("arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"); DescribeListenersResult response = client.describeListeners(request);
  - describeLoadBalancerAttributes
```
DescribeLoadBalancerAttributesResult describeLoadBalancerAttributes(DescribeLoadBalancerAttributesRequest describeLoadBalancerAttributesRequest)
```
    Describes the attributes for the specified Application Load Balancer or Network Load Balancer.
    Parameters:
    
    describeLoadBalancerAttributesRequest -
    
    Returns:
    
    Result of the DescribeLoadBalancerAttributes operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe load balancer attributes
      This example describes the attributes of the specified load balancer.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeLoadBalancerAttributesRequest request = new DescribeLoadBalancerAttributesRequest() .withLoadBalancerArn("arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"); DescribeLoadBalancerAttributesResult response = client .describeLoadBalancerAttributes(request);
  - describeLoadBalancers
```
DescribeLoadBalancersResult describeLoadBalancers(DescribeLoadBalancersRequest describeLoadBalancersRequest)
```
    Describes the specified load balancers or all of your load balancers.
    
    To describe the listeners for a load balancer, use DescribeListeners. To describe the attributes for a load balancer, use DescribeLoadBalancerAttributes.
    Parameters:
    
    describeLoadBalancersRequest -
    
    Returns:
    
    Result of the DescribeLoadBalancers operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe a load balancer
      This example describes the specified load balancer.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeLoadBalancersRequest request = new DescribeLoadBalancersRequest() .withLoadBalancerArns("arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"); DescribeLoadBalancersResult response = client .describeLoadBalancers(request);
  - describeRules
```
DescribeRulesResult describeRules(DescribeRulesRequest describeRulesRequest)
```
    Describes the specified rules or the rules for the specified listener. You must specify either a listener or one or more rules.
    Parameters:
    
    describeRulesRequest -
    
    Returns:
    
    Result of the DescribeRules operation returned by the service.
    
    Throws:
    
    ListenerNotFoundException - The specified listener does not exist.
    
    RuleNotFoundException - The specified rule does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe a rule
      This example describes the specified rule.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeRulesRequest request = new DescribeRulesRequest() .withRuleArns("arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee"); DescribeRulesResult response = client.describeRules(request);
  - describeSSLPolicies
```
DescribeSSLPoliciesResult describeSSLPolicies(DescribeSSLPoliciesRequest describeSSLPoliciesRequest)
```
    Describes the specified policies or all policies used for SSL negotiation.
    
    For more information, see Security Policies in the Application Load Balancers Guide.
    Parameters:
    
    describeSSLPoliciesRequest -
    
    Returns:
    
    Result of the DescribeSSLPolicies operation returned by the service.
    
    Throws:
    
    SSLPolicyNotFoundException - The specified SSL policy does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe a policy used for SSL negotiation
      This example describes the specified policy used for SSL negotiation.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeSSLPoliciesRequest request = new DescribeSSLPoliciesRequest() .withNames("ELBSecurityPolicy-2015-05"); DescribeSSLPoliciesResult response = client .describeSSLPolicies(request);
  - describeTags
```
DescribeTagsResult describeTags(DescribeTagsRequest describeTagsRequest)
```
    Describes the tags for the specified resources. You can describe the tags for one or more Application Load Balancers, Network Load Balancers, and target groups.
    Parameters:
    
    describeTagsRequest -
    
    Returns:
    
    Result of the DescribeTags operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    ListenerNotFoundException - The specified listener does not exist.
    
    RuleNotFoundException - The specified rule does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe the tags assigned to a load balancer
      This example describes the tags assigned to the specified load balancer.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeTagsRequest request = new DescribeTagsRequest() .withResourceArns("arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"); DescribeTagsResult response = client.describeTags(request);
  - describeTargetGroupAttributes
```
DescribeTargetGroupAttributesResult describeTargetGroupAttributes(DescribeTargetGroupAttributesRequest describeTargetGroupAttributesRequest)
```
    Describes the attributes for the specified target group.
    Parameters:
    
    describeTargetGroupAttributesRequest -
    
    Returns:
    
    Result of the DescribeTargetGroupAttributes operation returned by the service.
    
    Throws:
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe target group attributes
      This example describes the attributes of the specified target group.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeTargetGroupAttributesRequest request = new DescribeTargetGroupAttributesRequest() .withTargetGroupArn("arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"); DescribeTargetGroupAttributesResult response = client .describeTargetGroupAttributes(request);
  - describeTargetGroups
```
DescribeTargetGroupsResult describeTargetGroups(DescribeTargetGroupsRequest describeTargetGroupsRequest)
```
    Describes the specified target groups or all of your target groups. By default, all target groups are described. Alternatively, you can specify one of the following to filter the results: the ARN of the load balancer, the names of one or more target groups, or the ARNs of one or more target groups.
    
    To describe the targets for a target group, use DescribeTargetHealth. To describe the attributes of a target group, use DescribeTargetGroupAttributes.
    Parameters:
    
    describeTargetGroupsRequest -
    
    Returns:
    
    Result of the DescribeTargetGroups operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe a target group
      This example describes the specified target group.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeTargetGroupsRequest request = new DescribeTargetGroupsRequest() .withTargetGroupArns("arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"); DescribeTargetGroupsResult response = client .describeTargetGroups(request);
  - describeTargetHealth
```
DescribeTargetHealthResult describeTargetHealth(DescribeTargetHealthRequest describeTargetHealthRequest)
```
    Describes the health of the specified targets or all of your targets.
    Parameters:
    
    describeTargetHealthRequest -
    
    Returns:
    
    Result of the DescribeTargetHealth operation returned by the service.
    
    Throws:
    
    InvalidTargetException - The specified target does not exist, is not in the same VPC as the target group, or has an unsupported instance type.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    HealthUnavailableException - The health of the specified targets could not be retrieved due to an internal error.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To describe the health of a target
      This example describes the health of the specified target. This target is healthy.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeTargetHealthRequest request = new DescribeTargetHealthRequest() .withTargetGroupArn("arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"); DescribeTargetHealthResult response = client .describeTargetHealth(request);AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); DescribeTargetHealthRequest request = new DescribeTargetHealthRequest() .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067") .withTargets( new TargetDescription().withId("i-0f76fade").withPort( 80)); DescribeTargetHealthResult response = client .describeTargetHealth(request);
  - modifyListener
```
ModifyListenerResult modifyListener(ModifyListenerRequest modifyListenerRequest)
```
    Modifies the specified properties of the specified listener.
    
    Any properties that you do not specify retain their current values. However, changing the protocol from HTTPS to HTTP removes the security policy and SSL certificate properties. If you change the protocol from HTTP to HTTPS, you must add the security policy and server certificate.
    Parameters:
    
    modifyListenerRequest -
    
    Returns:
    
    Result of the ModifyListener operation returned by the service.
    
    Throws:
    
    DuplicateListenerException - A listener with the specified port already exists.
    
    TooManyListenersException - You've reached the limit on the number of listeners per load balancer.
    
    TooManyCertificatesException - You've reached the limit on the number of certificates per load balancer.
    
    ListenerNotFoundException - The specified listener does not exist.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    TargetGroupAssociationLimitException - You've reached the limit on the number of load balancers per target group.
    
    IncompatibleProtocolsException - The specified configuration is not valid with this protocol.
    
    SSLPolicyNotFoundException - The specified SSL policy does not exist.
    
    CertificateNotFoundException - The specified certificate does not exist.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    UnsupportedProtocolException - The specified protocol is not supported.
    
    TooManyRegistrationsForTargetIdException - You've reached the limit on the number of times a target can be registered with a load balancer.
    
    TooManyTargetsException - You've reached the limit on the number of targets.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To change the server certificate
      This example changes the server certificate for the specified HTTPS listener.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); ModifyListenerRequest request = new ModifyListenerRequest() .withDefaultActions( new Action() .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f") .withType("forward")) .withListenerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"); ModifyListenerResult response = client.modifyListener(request);AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); ModifyListenerRequest request = new ModifyListenerRequest() .withCertificates( new Certificate() .withCertificateArn("arn:aws:iam::123456789012:server-certificate/my-new-server-cert")) .withListenerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65"); ModifyListenerResult response = client.modifyListener(request);
  - modifyLoadBalancerAttributes
```
ModifyLoadBalancerAttributesResult modifyLoadBalancerAttributes(ModifyLoadBalancerAttributesRequest modifyLoadBalancerAttributesRequest)
```
    Modifies the specified attributes of the specified Application Load Balancer or Network Load Balancer.
    
    If any of the specified attributes can't be modified as requested, the call fails. Any existing attributes that you do not modify retain their current values.
    Parameters:
    
    modifyLoadBalancerAttributesRequest -
    
    Returns:
    
    Result of the ModifyLoadBalancerAttributes operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To enable access logs
      This example enables access logs for the specified load balancer. Note that the S3 bucket must exist in the same region as the load balancer and must have a policy attached that grants access to the Elastic Load Balancing service.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); ModifyLoadBalancerAttributesRequest request = new ModifyLoadBalancerAttributesRequest() .withAttributes( new LoadBalancerAttribute().withKey( "deletion_protection.enabled") .withValue("true")) .withLoadBalancerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"); ModifyLoadBalancerAttributesResult response = client .modifyLoadBalancerAttributes(request);AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); ModifyLoadBalancerAttributesRequest request = new ModifyLoadBalancerAttributesRequest() .withAttributes( new LoadBalancerAttribute().withKey( "idle_timeout.timeout_seconds").withValue("30")) .withLoadBalancerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"); ModifyLoadBalancerAttributesResult response = client .modifyLoadBalancerAttributes(request);AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); ModifyLoadBalancerAttributesRequest request = new ModifyLoadBalancerAttributesRequest() .withAttributes( new LoadBalancerAttribute().withKey( "access_logs.s3.enabled").withValue("true"), new LoadBalancerAttribute().withKey( "access_logs.s3.bucket").withValue( "my-loadbalancer-logs"), new LoadBalancerAttribute().withKey( "access_logs.s3.prefix").withValue("myapp")) .withLoadBalancerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"); ModifyLoadBalancerAttributesResult response = client .modifyLoadBalancerAttributes(request);
  - modifyRule
```
ModifyRuleResult modifyRule(ModifyRuleRequest modifyRuleRequest)
```
    Modifies the specified rule.
    
    Any existing properties that you do not modify retain their current values.
    
    To modify the default action, use ModifyListener.
    Parameters:
    
    modifyRuleRequest -
    
    Returns:
    
    Result of the ModifyRule operation returned by the service.
    
    Throws:
    
    TargetGroupAssociationLimitException - You've reached the limit on the number of load balancers per target group.
    
    IncompatibleProtocolsException - The specified configuration is not valid with this protocol.
    
    RuleNotFoundException - The specified rule does not exist.
    
    OperationNotPermittedException - This operation is not allowed.
    
    TooManyRegistrationsForTargetIdException - You've reached the limit on the number of times a target can be registered with a load balancer.
    
    TooManyTargetsException - You've reached the limit on the number of targets.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To modify a rule
      This example modifies the condition for the specified rule.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); ModifyRuleRequest request = new ModifyRuleRequest() .withConditions( new RuleCondition().withField("path-pattern") .withValues("/images/*")) .withRuleArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee"); ModifyRuleResult response = client.modifyRule(request);
  - modifyTargetGroup
```
ModifyTargetGroupResult modifyTargetGroup(ModifyTargetGroupRequest modifyTargetGroupRequest)
```
    Modifies the health checks used when evaluating the health state of the targets in the specified target group.
    
    To monitor the health of the targets, use DescribeTargetHealth.
    Parameters:
    
    modifyTargetGroupRequest -
    
    Returns:
    
    Result of the ModifyTargetGroup operation returned by the service.
    
    Throws:
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To modify the health check configuration for a target group
      This example changes the configuration of the health checks used to evaluate the health of the targets for the specified target group.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); ModifyTargetGroupRequest request = new ModifyTargetGroupRequest() .withHealthCheckPort("443") .withHealthCheckProtocol("HTTPS") .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f"); ModifyTargetGroupResult response = client.modifyTargetGroup(request);
  - modifyTargetGroupAttributes
```
ModifyTargetGroupAttributesResult modifyTargetGroupAttributes(ModifyTargetGroupAttributesRequest modifyTargetGroupAttributesRequest)
```
    Modifies the specified attributes of the specified target group.
    Parameters:
    
    modifyTargetGroupAttributesRequest -
    
    Returns:
    
    Result of the ModifyTargetGroupAttributes operation returned by the service.
    
    Throws:
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To modify the deregistration delay timeout
      This example sets the deregistration delay timeout to the specified value for the specified target group.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); ModifyTargetGroupAttributesRequest request = new ModifyTargetGroupAttributesRequest() .withAttributes( new TargetGroupAttribute().withKey( "deregistration_delay.timeout_seconds") .withValue("600")) .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"); ModifyTargetGroupAttributesResult response = client .modifyTargetGroupAttributes(request);
  - registerTargets
```
RegisterTargetsResult registerTargets(RegisterTargetsRequest registerTargetsRequest)
```
    Registers the specified targets with the specified target group.
    
    You can register targets by instance ID or by IP address. 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.
    Parameters:
    
    registerTargetsRequest -
    
    Returns:
    
    Result of the RegisterTargets operation returned by the service.
    
    Throws:
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    TooManyTargetsException - You've reached the limit on the number of targets.
    
    InvalidTargetException - The specified target does not exist, is not in the same VPC as the target group, or has an unsupported instance type.
    
    TooManyRegistrationsForTargetIdException - You've reached the limit on the number of times a target can be registered with a load balancer.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To register targets with a target group using port overrides
      This example registers the specified instance with the specified target group using multiple ports. This enables you to register ECS containers on the same instance as targets in the target group.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); RegisterTargetsRequest request = new RegisterTargetsRequest() .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067") .withTargets(new TargetDescription().withId("i-80c8dd94"), new TargetDescription().withId("i-ceddcd4d")); RegisterTargetsResult response = client.registerTargets(request);AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); RegisterTargetsRequest request = new RegisterTargetsRequest() .withTargetGroupArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/3bb63f11dfb0faf9") .withTargets( new TargetDescription().withId("i-80c8dd94").withPort( 80), new TargetDescription().withId("i-80c8dd94").withPort( 766)); RegisterTargetsResult response = client.registerTargets(request);
  - removeListenerCertificates
```
RemoveListenerCertificatesResult removeListenerCertificates(RemoveListenerCertificatesRequest removeListenerCertificatesRequest)
```
    Removes the specified certificate from the specified secure listener.
    
    You can't remove the default certificate for a listener. To replace the default certificate, call ModifyListener.
    
    To list the certificates for your listener, use DescribeListenerCertificates.
    
    Parameters:
    
    removeListenerCertificatesRequest -
    
    Returns:
    
    Result of the RemoveListenerCertificates operation returned by the service.
    
    Throws:
    
    ListenerNotFoundException - The specified listener does not exist.
    
    OperationNotPermittedException - This operation is not allowed.
    
    See Also:
    
    AWS API Documentation
  - removeTags
```
RemoveTagsResult removeTags(RemoveTagsRequest removeTagsRequest)
```
    Removes the specified tags from the specified Elastic Load Balancing resource.
    
    To list the current tags for your resources, use DescribeTags.
    Parameters:
    
    removeTagsRequest -
    
    Returns:
    
    Result of the RemoveTags operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    TargetGroupNotFoundException - The specified target group does not exist.
    
    ListenerNotFoundException - The specified listener does not exist.
    
    RuleNotFoundException - The specified rule does not exist.
    
    TooManyTagsException - You've reached the limit on the number of tags per load balancer.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To remove tags from a load balancer
      This example removes the specified tags from the specified load balancer.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); RemoveTagsRequest request = new RemoveTagsRequest() .withResourceArns( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188") .withTagKeys("project", "department"); RemoveTagsResult response = client.removeTags(request);
  - setIpAddressType
```
SetIpAddressTypeResult setIpAddressType(SetIpAddressTypeRequest setIpAddressTypeRequest)
```
    Sets the type of IP addresses used by the subnets of the specified Application Load Balancer or Network Load Balancer.
    
    Note that Network Load Balancers must use ipv4.
    
    Parameters:
    
    setIpAddressTypeRequest -
    
    Returns:
    
    Result of the SetIpAddressType operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    InvalidSubnetException - The specified subnet is out of available addresses.
    
    See Also:
    
    AWS API Documentation
  - setRulePriorities
```
SetRulePrioritiesResult setRulePriorities(SetRulePrioritiesRequest setRulePrioritiesRequest)
```
    Sets the priorities of the specified rules.
    
    You can reorder the rules as long as there are no priority conflicts in the new order. Any existing rules that you do not specify retain their current priority.
    Parameters:
    
    setRulePrioritiesRequest -
    
    Returns:
    
    Result of the SetRulePriorities operation returned by the service.
    
    Throws:
    
    RuleNotFoundException - The specified rule does not exist.
    
    PriorityInUseException - The specified priority is in use.
    
    OperationNotPermittedException - This operation is not allowed.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To set the rule priority
      This example sets the priority of the specified rule.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); SetRulePrioritiesRequest request = new SetRulePrioritiesRequest() .withRulePriorities(new RulePriorityPair() .withPriority(5) .withRuleArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3")); SetRulePrioritiesResult response = client.setRulePriorities(request);
  - setSecurityGroups
```
SetSecurityGroupsResult setSecurityGroups(SetSecurityGroupsRequest setSecurityGroupsRequest)
```
    Associates the specified security groups with the specified Application Load Balancer. The specified security groups override the previously associated security groups.
    
    Note that you can't specify a security group for a Network Load Balancer.
    Parameters:
    
    setSecurityGroupsRequest -
    
    Returns:
    
    Result of the SetSecurityGroups operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    InvalidSecurityGroupException - The specified security group does not exist.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To associate a security group with a load balancer
      This example associates the specified security group with the specified load balancer.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); SetSecurityGroupsRequest request = new SetSecurityGroupsRequest() .withLoadBalancerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188") .withSecurityGroups("sg-5943793c"); SetSecurityGroupsResult response = client.setSecurityGroups(request);
  - setSubnets
```
SetSubnetsResult setSubnets(SetSubnetsRequest setSubnetsRequest)
```
    Enables the Availability Zone for the specified subnets for the specified Application Load Balancer. The specified subnets replace the previously enabled subnets.
    
    Note that you can't change the subnets for a Network Load Balancer.
    Parameters:
    
    setSubnetsRequest -
    
    Returns:
    
    Result of the SetSubnets operation returned by the service.
    
    Throws:
    
    LoadBalancerNotFoundException - The specified load balancer does not exist.
    
    InvalidConfigurationRequestException - The requested configuration is not valid.
    
    SubnetNotFoundException - The specified subnet does not exist.
    
    InvalidSubnetException - The specified subnet is out of available addresses.
    
    AllocationIdNotFoundException - The specified allocation ID does not exist.
    
    AvailabilityZoneNotSupportedException - The specified Availability Zone is not supported.
    
    See Also:
    
    AWS API Documentation
    
    Samples:
    - To enable Availability Zones for a load balancer
      This example enables the Availability Zones for the specified subnets for the specified load balancer.
      
      AmazonElasticLoadBalancing client = new AmazonElasticLoadBalancingClient(); SetSubnetsRequest request = new SetSubnetsRequest() .withLoadBalancerArn( "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188") .withSubnets("subnet-8360a9e7", "subnet-b7d581c0"); SetSubnetsResult response = client.setSubnets(request);
  - shutdown
```
void shutdown()
```
    Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.
  - getCachedResponseMetadata
```
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
```
    Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.
    Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
    
    Parameters:
    
    request - The originally executed request.
    
    Returns:
    
    The response metadata for the specified request, or null if none is available.
  - waiters
```
AmazonElasticLoadBalancingWaiters waiters()
```

Did this page help you?

Interface AmazonElasticLoadBalancing

Field Summary

Method Summary

Field Detail

ENDPOINT_PREFIX

Method Detail

setEndpoint

setRegion

addListenerCertificates

addTags

To add tags to a load balancer

createListener

To create an HTTPS listener

createLoadBalancer

To create an internal load balancer

createRule

To create a rule

createTargetGroup

To create a target group

deleteListener

To delete a listener

deleteLoadBalancer

To delete a load balancer

deleteRule

To delete a rule

deleteTargetGroup

To delete a target group

deregisterTargets

To deregister a target from a target group

describeAccountLimits

describeListenerCertificates

describeListeners

To describe a listener

describeLoadBalancerAttributes

To describe load balancer attributes

describeLoadBalancers

To describe a load balancer

describeRules

To describe a rule

describeSSLPolicies

To describe a policy used for SSL negotiation

describeTags

To describe the tags assigned to a load balancer

describeTargetGroupAttributes

To describe target group attributes

describeTargetGroups

To describe a target group

describeTargetHealth

To describe the health of a target

modifyListener

To change the server certificate

modifyLoadBalancerAttributes

To enable access logs

modifyRule

To modify a rule

modifyTargetGroup

To modify the health check configuration for a target group

modifyTargetGroupAttributes

To modify the deregistration delay timeout

registerTargets

To register targets with a target group using port overrides

removeListenerCertificates

removeTags

To remove tags from a load balancer

setIpAddressType

setRulePriorities

To set the rule priority

setSecurityGroups

To associate a security group with a load balancer

setSubnets

To enable Availability Zones for a load balancer

shutdown

getCachedResponseMetadata

waiters