Class: Aws::ElasticLoadBalancingV2::Types::ModifyTargetGroupInput

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-elasticloadbalancingv2/types.rb

Overview

Note:

When making an API call, you may pass ModifyTargetGroupInput data as a hash:

{
  target_group_arn: "TargetGroupArn", # required
  health_check_protocol: "HTTP", # accepts HTTP, HTTPS, TCP, TLS, UDP, TCP_UDP, GENEVE
  health_check_port: "HealthCheckPort",
  health_check_path: "Path",
  health_check_enabled: false,
  health_check_interval_seconds: 1,
  health_check_timeout_seconds: 1,
  healthy_threshold_count: 1,
  unhealthy_threshold_count: 1,
  matcher: {
    http_code: "HttpCode",
    grpc_code: "GrpcCode",
  },
}

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#health_check_enabledBoolean

Indicates whether health checks are enabled.

Returns:

  • (Boolean)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#health_check_interval_secondsInteger

The approximate amount of time, in seconds, between health checks of an individual target. For TCP health checks, the supported values are 10 or 30 seconds.

With Network Load Balancers, you can't modify this setting.

Returns:

  • (Integer)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#health_check_pathString

[HTTP/HTTPS health checks] The destination for health checks on the targets.

[HTTP1 or HTTP2 protocol version] The ping path. The default is /.

[GRPC protocol version] The path of a custom health check method with the format /package.service/method. The default is /AWS.ALB/healthcheck.

Returns:

  • (String)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#health_check_portString

The port the load balancer uses when performing health checks on targets.

Returns:

  • (String)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#health_check_protocolString

The protocol the load balancer uses when performing health checks on targets. The TCP protocol is supported for health checks only if the protocol of the target group is TCP, TLS, UDP, or TCP_UDP. The GENEVE, TLS, UDP, and TCP_UDP protocols are not supported for health checks.

With Network Load Balancers, you can't modify this setting.

Returns:

  • (String)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#health_check_timeout_secondsInteger

[HTTP/HTTPS health checks] The amount of time, in seconds, during which no response means a failed health check.

With Network Load Balancers, you can't modify this setting.

Returns:

  • (Integer)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#healthy_threshold_countInteger

The number of consecutive health checks successes required before considering an unhealthy target healthy.

Returns:

  • (Integer)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#matcherTypes::Matcher

[HTTP/HTTPS health checks] The HTTP or gRPC codes to use when checking for a successful response from a target.

With Network Load Balancers, you can't modify this setting.

Returns:


2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#target_group_arnString

The Amazon Resource Name (ARN) of the target group.

Returns:

  • (String)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end

#unhealthy_threshold_countInteger

The number of consecutive health check failures required before considering the target unhealthy. For target groups with a protocol of TCP or TLS, this value must be the same as the healthy threshold count.

Returns:

  • (Integer)

2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
# File 'lib/aws-sdk-elasticloadbalancingv2/types.rb', line 2963

class ModifyTargetGroupInput < Struct.new(
  :target_group_arn,
  :health_check_protocol,
  :health_check_port,
  :health_check_path,
  :health_check_enabled,
  :health_check_interval_seconds,
  :health_check_timeout_seconds,
  :healthy_threshold_count,
  :unhealthy_threshold_count,
  :matcher)
  SENSITIVE = []
  include Aws::Structure
end