All Downloads are FREE. Search and download functionalities are using the official Maven repository.

software.amazon.awssdk.services.elasticloadbalancingv2.model.TargetGroupAttribute Maven / Gradle / Ivy

Go to download

The AWS Java SDK for Elastic Load Balancing module holds the client classes that are used for communicating with Elastic Load Balancing Service (API Version 2015-12-01)

There is a newer version: 2.29.39
Show newest version
/*
 * Copyright 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 software.amazon.awssdk.services.elasticloadbalancingv2.model;

import java.io.Serializable;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Optional;
import java.util.function.BiConsumer;
import java.util.function.Function;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.core.SdkField;
import software.amazon.awssdk.core.SdkPojo;
import software.amazon.awssdk.core.protocol.MarshallLocation;
import software.amazon.awssdk.core.protocol.MarshallingType;
import software.amazon.awssdk.core.traits.LocationTrait;
import software.amazon.awssdk.utils.ToString;
import software.amazon.awssdk.utils.builder.CopyableBuilder;
import software.amazon.awssdk.utils.builder.ToCopyableBuilder;

/**
 * 

* Information about a target group attribute. *

*/ @Generated("software.amazon.awssdk:codegen") public final class TargetGroupAttribute implements SdkPojo, Serializable, ToCopyableBuilder { private static final SdkField KEY_FIELD = SdkField. builder(MarshallingType.STRING).memberName("Key") .getter(getter(TargetGroupAttribute::key)).setter(setter(Builder::key)) .traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("Key").build()).build(); private static final SdkField VALUE_FIELD = SdkField. builder(MarshallingType.STRING).memberName("Value") .getter(getter(TargetGroupAttribute::value)).setter(setter(Builder::value)) .traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("Value").build()).build(); private static final List> SDK_FIELDS = Collections.unmodifiableList(Arrays.asList(KEY_FIELD, VALUE_FIELD)); private static final Map> SDK_NAME_TO_FIELD = memberNameToFieldInitializer(); private static final long serialVersionUID = 1L; private final String key; private final String value; private TargetGroupAttribute(BuilderImpl builder) { this.key = builder.key; this.value = builder.value; } /** *

* The name of the attribute. *

*

* The following attributes are supported by all load balancers: *

*
    *
  • *

    * deregistration_delay.timeout_seconds - The amount of time, in seconds, for Elastic Load Balancing to * wait before changing the state of a deregistering target from draining to unused. The * range is 0-3600 seconds. The default value is 300 seconds. If the target is a Lambda function, this attribute is * not supported. *

    *
  • *
  • *

    * stickiness.enabled - Indicates whether target stickiness is enabled. The value is true * or false. The default is false. *

    *
  • *
  • *

    * stickiness.type - Indicates the type of stickiness. The possible values are: *

    *
      *
    • *

      * lb_cookie and app_cookie for Application Load Balancers. *

      *
    • *
    • *

      * source_ip for Network Load Balancers. *

      *
    • *
    • *

      * source_ip_dest_ip and source_ip_dest_ip_proto for Gateway Load Balancers. *

      *
    • *
    *
  • *
*

* The following attributes are supported by Application Load Balancers and Network Load Balancers: *

*
    *
  • *

    * load_balancing.cross_zone.enabled - Indicates whether cross zone load balancing is enabled. The * value is true, false or use_load_balancer_configuration. The default is * use_load_balancer_configuration. *

    *
  • *
  • *

    * target_group_health.dns_failover.minimum_healthy_targets.count - The minimum number of targets that * must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that * traffic is routed only to healthy zones. The possible values are off or an integer from 1 to the * maximum number of targets. The default is off. *

    *
  • *
  • *

    * target_group_health.dns_failover.minimum_healthy_targets.percentage - The minimum percentage of * targets that must be healthy. If the percentage of healthy targets is below this value, mark the zone as * unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are off or an * integer from 1 to 100. The default is off. *

    *
  • *
  • *

    * target_group_health.unhealthy_state_routing.minimum_healthy_targets.count - The minimum number of * targets that must be healthy. If the number of healthy targets is below this value, send traffic to all targets, * including unhealthy targets. The possible values are 1 to the maximum number of targets. The default is 1. *

    *
  • *
  • *

    * target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage - The minimum * percentage of targets that must be healthy. If the percentage of healthy targets is below this value, send * traffic to all targets, including unhealthy targets. The possible values are off or an integer from * 1 to 100. The default is off. *

    *
  • *
*

* The following attributes are supported only if the load balancer is an Application Load Balancer and the target * is an instance or an IP address: *

*
    *
  • *

    * load_balancing.algorithm.type - The load balancing algorithm determines how the load balancer * selects targets when routing requests. The value is round_robin, * least_outstanding_requests, or weighted_random. The default is round_robin * . *

    *
  • *
  • *

    * load_balancing.algorithm.anomaly_mitigation - Only available when * load_balancing.algorithm.type is weighted_random. Indicates whether anomaly mitigation * is enabled. The value is on or off. The default is off. *

    *
  • *
  • *

    * slow_start.duration_seconds - The time period, in seconds, during which a newly registered target * receives an increasing share of the traffic to the target group. After this time period ends, the target receives * its full share of traffic. The range is 30-900 seconds (15 minutes). The default is 0 seconds (disabled). *

    *
  • *
  • *

    * stickiness.app_cookie.cookie_name - Indicates the name of the application-based cookie. Names that * start with the following prefixes are not allowed: AWSALB, AWSALBAPP, and * AWSALBTG; they're reserved for use by the load balancer. *

    *
  • *
  • *

    * stickiness.app_cookie.duration_seconds - The time period, in seconds, during which requests from a * client should be routed to the same target. After this time period expires, the application-based cookie is * considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds). *

    *
  • *
  • *

    * stickiness.lb_cookie.duration_seconds - The time period, in seconds, during which requests from a * client should be routed to the same target. After this time period expires, the load balancer-generated cookie is * considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds). *

    *
  • *
*

* The following attribute is supported only if the load balancer is an Application Load Balancer and the target is * a Lambda function: *

*
    *
  • *

    * lambda.multi_value_headers.enabled - Indicates whether the request and response headers that are * exchanged between the load balancer and the Lambda function include arrays of values or strings. The value is * true or false. The default is false. If the value is false * and the request contains a duplicate header field name or query parameter key, the load balancer uses the last * value sent by the client. *

    *
  • *
*

* The following attributes are supported only by Network Load Balancers: *

*
    *
  • *

    * deregistration_delay.connection_termination.enabled - Indicates whether the load balancer terminates * connections at the end of the deregistration timeout. The value is true or false. For * new UDP/TCP_UDP target groups the default is true. Otherwise, the default is false. *

    *
  • *
  • *

    * preserve_client_ip.enabled - Indicates whether client IP preservation is enabled. The value is * true or false. The default is disabled if the target group type is IP address and the * target group protocol is TCP or TLS. Otherwise, the default is enabled. Client IP preservation can't be disabled * for UDP and TCP_UDP target groups. *

    *
  • *
  • *

    * proxy_protocol_v2.enabled - Indicates whether Proxy Protocol version 2 is enabled. The value is * true or false. The default is false. *

    *
  • *
  • *

    * target_health_state.unhealthy.connection_termination.enabled - Indicates whether the load balancer * terminates connections to unhealthy targets. The value is true or false. The default is * true. *

    *
  • *
  • *

    * target_health_state.unhealthy.draining_interval_seconds - The amount of time for Elastic Load * Balancing to wait before changing the state of an unhealthy target from unhealthy.draining to * unhealthy. The range is 0-360000 seconds. The default value is 0 seconds. *

    *

    * Note: This attribute can only be configured when * target_health_state.unhealthy.connection_termination.enabled is false. *

    *
  • *
*

* The following attributes are supported only by Gateway Load Balancers: *

*
    *
  • *

    * target_failover.on_deregistration - Indicates how the Gateway Load Balancer handles existing flows * when a target is deregistered. The possible values are rebalance and no_rebalance. The * default is no_rebalance. The two attributes (target_failover.on_deregistration and * target_failover.on_unhealthy) can't be set independently. The value you set for both attributes must * be the same. *

    *
  • *
  • *

    * target_failover.on_unhealthy - Indicates how the Gateway Load Balancer handles existing flows when a * target is unhealthy. The possible values are rebalance and no_rebalance. The default is * no_rebalance. The two attributes (target_failover.on_deregistration and * target_failover.on_unhealthy) can't be set independently. The value you set for both attributes must * be the same. *

    *
  • *
* * @return The name of the attribute.

*

* The following attributes are supported by all load balancers: *

*
    *
  • *

    * deregistration_delay.timeout_seconds - The amount of time, in seconds, for Elastic Load * Balancing to wait before changing the state of a deregistering target from draining to * unused. The range is 0-3600 seconds. The default value is 300 seconds. If the target is a * Lambda function, this attribute is not supported. *

    *
  • *
  • *

    * stickiness.enabled - Indicates whether target stickiness is enabled. The value is * true or false. The default is false. *

    *
  • *
  • *

    * stickiness.type - Indicates the type of stickiness. The possible values are: *

    *
      *
    • *

      * lb_cookie and app_cookie for Application Load Balancers. *

      *
    • *
    • *

      * source_ip for Network Load Balancers. *

      *
    • *
    • *

      * source_ip_dest_ip and source_ip_dest_ip_proto for Gateway Load Balancers. *

      *
    • *
    *
  • *
*

* The following attributes are supported by Application Load Balancers and Network Load Balancers: *

*
    *
  • *

    * load_balancing.cross_zone.enabled - Indicates whether cross zone load balancing is enabled. * The value is true, false or use_load_balancer_configuration. The * default is use_load_balancer_configuration. *

    *
  • *
  • *

    * target_group_health.dns_failover.minimum_healthy_targets.count - The minimum number of * targets that must be healthy. If the number of healthy targets is below this value, mark the zone as * unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are * off or an integer from 1 to the maximum number of targets. The default is off. *

    *
  • *
  • *

    * target_group_health.dns_failover.minimum_healthy_targets.percentage - The minimum percentage * of targets that must be healthy. If the percentage of healthy targets is below this value, mark the zone * as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are * off or an integer from 1 to 100. The default is off. *

    *
  • *
  • *

    * target_group_health.unhealthy_state_routing.minimum_healthy_targets.count - The minimum * number of targets that must be healthy. If the number of healthy targets is below this value, send * traffic to all targets, including unhealthy targets. The possible values are 1 to the maximum number of * targets. The default is 1. *

    *
  • *
  • *

    * target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage - The minimum * percentage of targets that must be healthy. If the percentage of healthy targets is below this value, * send traffic to all targets, including unhealthy targets. The possible values are off or an * integer from 1 to 100. The default is off. *

    *
  • *
*

* The following attributes are supported only if the load balancer is an Application Load Balancer and the * target is an instance or an IP address: *

*
    *
  • *

    * load_balancing.algorithm.type - The load balancing algorithm determines how the load * balancer selects targets when routing requests. The value is round_robin, * least_outstanding_requests, or weighted_random. The default is * round_robin. *

    *
  • *
  • *

    * load_balancing.algorithm.anomaly_mitigation - Only available when * load_balancing.algorithm.type is weighted_random. Indicates whether anomaly * mitigation is enabled. The value is on or off. The default is off. *

    *
  • *
  • *

    * slow_start.duration_seconds - The time period, in seconds, during which a newly registered * target receives an increasing share of the traffic to the target group. After this time period ends, the * target receives its full share of traffic. The range is 30-900 seconds (15 minutes). The default is 0 * seconds (disabled). *

    *
  • *
  • *

    * stickiness.app_cookie.cookie_name - Indicates the name of the application-based cookie. * Names that start with the following prefixes are not allowed: AWSALB, AWSALBAPP * , and AWSALBTG; they're reserved for use by the load balancer. *

    *
  • *
  • *

    * stickiness.app_cookie.duration_seconds - The time period, in seconds, during which requests * from a client should be routed to the same target. After this time period expires, the application-based * cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day * (86400 seconds). *

    *
  • *
  • *

    * stickiness.lb_cookie.duration_seconds - The time period, in seconds, during which requests * from a client should be routed to the same target. After this time period expires, the load * balancer-generated cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The * default value is 1 day (86400 seconds). *

    *
  • *
*

* The following attribute is supported only if the load balancer is an Application Load Balancer and the * target is a Lambda function: *

*
    *
  • *

    * lambda.multi_value_headers.enabled - Indicates whether the request and response headers that * are exchanged between the load balancer and the Lambda function include arrays of values or strings. The * value is true or false. The default is false. If the value is * false and the request contains a duplicate header field name or query parameter key, the * load balancer uses the last value sent by the client. *

    *
  • *
*

* The following attributes are supported only by Network Load Balancers: *

*
    *
  • *

    * deregistration_delay.connection_termination.enabled - Indicates whether the load balancer * terminates connections at the end of the deregistration timeout. The value is true or * false. For new UDP/TCP_UDP target groups the default is true. Otherwise, the * default is false. *

    *
  • *
  • *

    * preserve_client_ip.enabled - Indicates whether client IP preservation is enabled. The value * is true or false. The default is disabled if the target group type is IP * address and the target group protocol is TCP or TLS. Otherwise, the default is enabled. Client IP * preservation can't be disabled for UDP and TCP_UDP target groups. *

    *
  • *
  • *

    * proxy_protocol_v2.enabled - Indicates whether Proxy Protocol version 2 is enabled. The value * is true or false. The default is false. *

    *
  • *
  • *

    * target_health_state.unhealthy.connection_termination.enabled - Indicates whether the load * balancer terminates connections to unhealthy targets. The value is true or * false. The default is true. *

    *
  • *
  • *

    * target_health_state.unhealthy.draining_interval_seconds - The amount of time for Elastic * Load Balancing to wait before changing the state of an unhealthy target from * unhealthy.draining to unhealthy. The range is 0-360000 seconds. The default * value is 0 seconds. *

    *

    * Note: This attribute can only be configured when * target_health_state.unhealthy.connection_termination.enabled is false. *

    *
  • *
*

* The following attributes are supported only by Gateway Load Balancers: *

*
    *
  • *

    * target_failover.on_deregistration - Indicates how the Gateway Load Balancer handles existing * flows when a target is deregistered. The possible values are rebalance and * no_rebalance. The default is no_rebalance. The two attributes ( * target_failover.on_deregistration and target_failover.on_unhealthy) can't be * set independently. The value you set for both attributes must be the same. *

    *
  • *
  • *

    * target_failover.on_unhealthy - Indicates how the Gateway Load Balancer handles existing * flows when a target is unhealthy. The possible values are rebalance and * no_rebalance. The default is no_rebalance. The two attributes ( * target_failover.on_deregistration and target_failover.on_unhealthy) can't be * set independently. The value you set for both attributes must be the same. *

    *
  • */ public final String key() { return key; } /** *

    * The value of the attribute. *

    * * @return The value of the attribute. */ public final String value() { return value; } @Override public Builder toBuilder() { return new BuilderImpl(this); } public static Builder builder() { return new BuilderImpl(); } public static Class serializableBuilderClass() { return BuilderImpl.class; } @Override public final int hashCode() { int hashCode = 1; hashCode = 31 * hashCode + Objects.hashCode(key()); hashCode = 31 * hashCode + Objects.hashCode(value()); return hashCode; } @Override public final boolean equals(Object obj) { return equalsBySdkFields(obj); } @Override public final boolean equalsBySdkFields(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (!(obj instanceof TargetGroupAttribute)) { return false; } TargetGroupAttribute other = (TargetGroupAttribute) obj; return Objects.equals(key(), other.key()) && Objects.equals(value(), other.value()); } /** * Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be * redacted from this string using a placeholder value. */ @Override public final String toString() { return ToString.builder("TargetGroupAttribute").add("Key", key()).add("Value", value()).build(); } public final Optional getValueForField(String fieldName, Class clazz) { switch (fieldName) { case "Key": return Optional.ofNullable(clazz.cast(key())); case "Value": return Optional.ofNullable(clazz.cast(value())); default: return Optional.empty(); } } @Override public final List> sdkFields() { return SDK_FIELDS; } @Override public final Map> sdkFieldNameToField() { return SDK_NAME_TO_FIELD; } private static Map> memberNameToFieldInitializer() { Map> map = new HashMap<>(); map.put("Key", KEY_FIELD); map.put("Value", VALUE_FIELD); return Collections.unmodifiableMap(map); } private static Function getter(Function g) { return obj -> g.apply((TargetGroupAttribute) obj); } private static BiConsumer setter(BiConsumer s) { return (obj, val) -> s.accept((Builder) obj, val); } public interface Builder extends SdkPojo, CopyableBuilder { /** *

    * The name of the attribute. *

    *

    * The following attributes are supported by all load balancers: *

    *
      *
    • *

      * deregistration_delay.timeout_seconds - The amount of time, in seconds, for Elastic Load * Balancing to wait before changing the state of a deregistering target from draining to * unused. The range is 0-3600 seconds. The default value is 300 seconds. If the target is a Lambda * function, this attribute is not supported. *

      *
    • *
    • *

      * stickiness.enabled - Indicates whether target stickiness is enabled. The value is * true or false. The default is false. *

      *
    • *
    • *

      * stickiness.type - Indicates the type of stickiness. The possible values are: *

      *
        *
      • *

        * lb_cookie and app_cookie for Application Load Balancers. *

        *
      • *
      • *

        * source_ip for Network Load Balancers. *

        *
      • *
      • *

        * source_ip_dest_ip and source_ip_dest_ip_proto for Gateway Load Balancers. *

        *
      • *
      *
    • *
    *

    * The following attributes are supported by Application Load Balancers and Network Load Balancers: *

    *
      *
    • *

      * load_balancing.cross_zone.enabled - Indicates whether cross zone load balancing is enabled. The * value is true, false or use_load_balancer_configuration. The default * is use_load_balancer_configuration. *

      *
    • *
    • *

      * target_group_health.dns_failover.minimum_healthy_targets.count - The minimum number of targets * that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in * DNS, so that traffic is routed only to healthy zones. The possible values are off or an integer * from 1 to the maximum number of targets. The default is off. *

      *
    • *
    • *

      * target_group_health.dns_failover.minimum_healthy_targets.percentage - The minimum percentage of * targets that must be healthy. If the percentage of healthy targets is below this value, mark the zone as * unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are off * or an integer from 1 to 100. The default is off. *

      *
    • *
    • *

      * target_group_health.unhealthy_state_routing.minimum_healthy_targets.count - The minimum number * of targets that must be healthy. If the number of healthy targets is below this value, send traffic to all * targets, including unhealthy targets. The possible values are 1 to the maximum number of targets. The default * is 1. *

      *
    • *
    • *

      * target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage - The minimum * percentage of targets that must be healthy. If the percentage of healthy targets is below this value, send * traffic to all targets, including unhealthy targets. The possible values are off or an integer * from 1 to 100. The default is off. *

      *
    • *
    *

    * The following attributes are supported only if the load balancer is an Application Load Balancer and the * target is an instance or an IP address: *

    *
      *
    • *

      * load_balancing.algorithm.type - The load balancing algorithm determines how the load balancer * selects targets when routing requests. The value is round_robin, * least_outstanding_requests, or weighted_random. The default is * round_robin. *

      *
    • *
    • *

      * load_balancing.algorithm.anomaly_mitigation - Only available when * load_balancing.algorithm.type is weighted_random. Indicates whether anomaly * mitigation is enabled. The value is on or off. The default is off. *

      *
    • *
    • *

      * slow_start.duration_seconds - The time period, in seconds, during which a newly registered * target receives an increasing share of the traffic to the target group. After this time period ends, the * target receives its full share of traffic. The range is 30-900 seconds (15 minutes). The default is 0 seconds * (disabled). *

      *
    • *
    • *

      * stickiness.app_cookie.cookie_name - Indicates the name of the application-based cookie. Names * that start with the following prefixes are not allowed: AWSALB, AWSALBAPP, and * AWSALBTG; they're reserved for use by the load balancer. *

      *
    • *
    • *

      * stickiness.app_cookie.duration_seconds - The time period, in seconds, during which requests from * a client should be routed to the same target. After this time period expires, the application-based cookie is * considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 * seconds). *

      *
    • *
    • *

      * stickiness.lb_cookie.duration_seconds - The time period, in seconds, during which requests from * a client should be routed to the same target. After this time period expires, the load balancer-generated * cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day * (86400 seconds). *

      *
    • *
    *

    * The following attribute is supported only if the load balancer is an Application Load Balancer and the target * is a Lambda function: *

    *
      *
    • *

      * lambda.multi_value_headers.enabled - Indicates whether the request and response headers that are * exchanged between the load balancer and the Lambda function include arrays of values or strings. The value is * true or false. The default is false. If the value is * false and the request contains a duplicate header field name or query parameter key, the load * balancer uses the last value sent by the client. *

      *
    • *
    *

    * The following attributes are supported only by Network Load Balancers: *

    *
      *
    • *

      * deregistration_delay.connection_termination.enabled - Indicates whether the load balancer * terminates connections at the end of the deregistration timeout. The value is true or * false. For new UDP/TCP_UDP target groups the default is true. Otherwise, the * default is false. *

      *
    • *
    • *

      * preserve_client_ip.enabled - Indicates whether client IP preservation is enabled. The value is * true or false. The default is disabled if the target group type is IP address and * the target group protocol is TCP or TLS. Otherwise, the default is enabled. Client IP preservation can't be * disabled for UDP and TCP_UDP target groups. *

      *
    • *
    • *

      * proxy_protocol_v2.enabled - Indicates whether Proxy Protocol version 2 is enabled. The value is * true or false. The default is false. *

      *
    • *
    • *

      * target_health_state.unhealthy.connection_termination.enabled - Indicates whether the load * balancer terminates connections to unhealthy targets. The value is true or false. * The default is true. *

      *
    • *
    • *

      * target_health_state.unhealthy.draining_interval_seconds - The amount of time for Elastic Load * Balancing to wait before changing the state of an unhealthy target from unhealthy.draining to * unhealthy. The range is 0-360000 seconds. The default value is 0 seconds. *

      *

      * Note: This attribute can only be configured when * target_health_state.unhealthy.connection_termination.enabled is false. *

      *
    • *
    *

    * The following attributes are supported only by Gateway Load Balancers: *

    *
      *
    • *

      * target_failover.on_deregistration - Indicates how the Gateway Load Balancer handles existing * flows when a target is deregistered. The possible values are rebalance and * no_rebalance. The default is no_rebalance. The two attributes ( * target_failover.on_deregistration and target_failover.on_unhealthy) can't be set * independently. The value you set for both attributes must be the same. *

      *
    • *
    • *

      * target_failover.on_unhealthy - Indicates how the Gateway Load Balancer handles existing flows * when a target is unhealthy. The possible values are rebalance and no_rebalance. The * default is no_rebalance. The two attributes (target_failover.on_deregistration and * target_failover.on_unhealthy) can't be set independently. The value you set for both attributes * must be the same. *

      *
    • *
    * * @param key * The name of the attribute.

    *

    * The following attributes are supported by all load balancers: *

    *
      *
    • *

      * deregistration_delay.timeout_seconds - The amount of time, in seconds, for Elastic Load * Balancing to wait before changing the state of a deregistering target from draining to * unused. The range is 0-3600 seconds. The default value is 300 seconds. If the target is a * Lambda function, this attribute is not supported. *

      *
    • *
    • *

      * stickiness.enabled - Indicates whether target stickiness is enabled. The value is * true or false. The default is false. *

      *
    • *
    • *

      * stickiness.type - Indicates the type of stickiness. The possible values are: *

      *
        *
      • *

        * lb_cookie and app_cookie for Application Load Balancers. *

        *
      • *
      • *

        * source_ip for Network Load Balancers. *

        *
      • *
      • *

        * source_ip_dest_ip and source_ip_dest_ip_proto for Gateway Load Balancers. *

        *
      • *
      *
    • *
    *

    * The following attributes are supported by Application Load Balancers and Network Load Balancers: *

    *
      *
    • *

      * load_balancing.cross_zone.enabled - Indicates whether cross zone load balancing is * enabled. The value is true, false or * use_load_balancer_configuration. The default is * use_load_balancer_configuration. *

      *
    • *
    • *

      * target_group_health.dns_failover.minimum_healthy_targets.count - The minimum number of * targets that must be healthy. If the number of healthy targets is below this value, mark the zone as * unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are * off or an integer from 1 to the maximum number of targets. The default is * off. *

      *
    • *
    • *

      * target_group_health.dns_failover.minimum_healthy_targets.percentage - The minimum * percentage of targets that must be healthy. If the percentage of healthy targets is below this value, * mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible * values are off or an integer from 1 to 100. The default is off. *

      *
    • *
    • *

      * target_group_health.unhealthy_state_routing.minimum_healthy_targets.count - The minimum * number of targets that must be healthy. If the number of healthy targets is below this value, send * traffic to all targets, including unhealthy targets. The possible values are 1 to the maximum number * of targets. The default is 1. *

      *
    • *
    • *

      * target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage - The * minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this * value, send traffic to all targets, including unhealthy targets. The possible values are * off or an integer from 1 to 100. The default is off. *

      *
    • *
    *

    * The following attributes are supported only if the load balancer is an Application Load Balancer and * the target is an instance or an IP address: *

    *
      *
    • *

      * load_balancing.algorithm.type - The load balancing algorithm determines how the load * balancer selects targets when routing requests. The value is round_robin, * least_outstanding_requests, or weighted_random. The default is * round_robin. *

      *
    • *
    • *

      * load_balancing.algorithm.anomaly_mitigation - Only available when * load_balancing.algorithm.type is weighted_random. Indicates whether anomaly * mitigation is enabled. The value is on or off. The default is * off. *

      *
    • *
    • *

      * slow_start.duration_seconds - The time period, in seconds, during which a newly * registered target receives an increasing share of the traffic to the target group. After this time * period ends, the target receives its full share of traffic. The range is 30-900 seconds (15 minutes). * The default is 0 seconds (disabled). *

      *
    • *
    • *

      * stickiness.app_cookie.cookie_name - Indicates the name of the application-based cookie. * Names that start with the following prefixes are not allowed: AWSALB, * AWSALBAPP, and AWSALBTG; they're reserved for use by the load balancer. *

      *
    • *
    • *

      * stickiness.app_cookie.duration_seconds - The time period, in seconds, during which * requests from a client should be routed to the same target. After this time period expires, the * application-based cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The * default value is 1 day (86400 seconds). *

      *
    • *
    • *

      * stickiness.lb_cookie.duration_seconds - The time period, in seconds, during which * requests from a client should be routed to the same target. After this time period expires, the load * balancer-generated cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The * default value is 1 day (86400 seconds). *

      *
    • *
    *

    * The following attribute is supported only if the load balancer is an Application Load Balancer and the * target is a Lambda function: *

    *
      *
    • *

      * lambda.multi_value_headers.enabled - Indicates whether the request and response headers * that are exchanged between the load balancer and the Lambda function include arrays of values or * strings. The value is true or false. The default is false. If * the value is false and the request contains a duplicate header field name or query * parameter key, the load balancer uses the last value sent by the client. *

      *
    • *
    *

    * The following attributes are supported only by Network Load Balancers: *

    *
      *
    • *

      * deregistration_delay.connection_termination.enabled - Indicates whether the load balancer * terminates connections at the end of the deregistration timeout. The value is true or * false. For new UDP/TCP_UDP target groups the default is true. Otherwise, the * default is false. *

      *
    • *
    • *

      * preserve_client_ip.enabled - Indicates whether client IP preservation is enabled. The * value is true or false. The default is disabled if the target group type is * IP address and the target group protocol is TCP or TLS. Otherwise, the default is enabled. Client IP * preservation can't be disabled for UDP and TCP_UDP target groups. *

      *
    • *
    • *

      * proxy_protocol_v2.enabled - Indicates whether Proxy Protocol version 2 is enabled. The * value is true or false. The default is false. *

      *
    • *
    • *

      * target_health_state.unhealthy.connection_termination.enabled - Indicates whether the load * balancer terminates connections to unhealthy targets. The value is true or * false. The default is true. *

      *
    • *
    • *

      * target_health_state.unhealthy.draining_interval_seconds - The amount of time for Elastic * Load Balancing to wait before changing the state of an unhealthy target from * unhealthy.draining to unhealthy. The range is 0-360000 seconds. The default * value is 0 seconds. *

      *

      * Note: This attribute can only be configured when * target_health_state.unhealthy.connection_termination.enabled is false. *

      *
    • *
    *

    * The following attributes are supported only by Gateway Load Balancers: *

    *
      *
    • *

      * target_failover.on_deregistration - Indicates how the Gateway Load Balancer handles * existing flows when a target is deregistered. The possible values are rebalance and * no_rebalance. The default is no_rebalance. The two attributes ( * target_failover.on_deregistration and target_failover.on_unhealthy) can't be * set independently. The value you set for both attributes must be the same. *

      *
    • *
    • *

      * target_failover.on_unhealthy - Indicates how the Gateway Load Balancer handles existing * flows when a target is unhealthy. The possible values are rebalance and * no_rebalance. The default is no_rebalance. The two attributes ( * target_failover.on_deregistration and target_failover.on_unhealthy) can't be * set independently. The value you set for both attributes must be the same. *

      *
    • * @return Returns a reference to this object so that method calls can be chained together. */ Builder key(String key); /** *

      * The value of the attribute. *

      * * @param value * The value of the attribute. * @return Returns a reference to this object so that method calls can be chained together. */ Builder value(String value); } static final class BuilderImpl implements Builder { private String key; private String value; private BuilderImpl() { } private BuilderImpl(TargetGroupAttribute model) { key(model.key); value(model.value); } public final String getKey() { return key; } public final void setKey(String key) { this.key = key; } @Override public final Builder key(String key) { this.key = key; return this; } public final String getValue() { return value; } public final void setValue(String value) { this.value = value; } @Override public final Builder value(String value) { this.value = value; return this; } @Override public TargetGroupAttribute build() { return new TargetGroupAttribute(this); } @Override public List> sdkFields() { return SDK_FIELDS; } @Override public Map> sdkFieldNameToField() { return SDK_NAME_TO_FIELD; } } }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy