Skip to content

/AWS1/CL_EL2=>MODIFYTARGETGROUP()

About ModifyTargetGroup

Modifies the health checks used when evaluating the health state of the targets in the specified target group.

Method Signature

IMPORTING

Required arguments:

IV_TARGETGROUPARN TYPE /AWS1/EL2TARGETGROUPARN /AWS1/EL2TARGETGROUPARN

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

Optional arguments:

IV_HEALTHCHECKPROTOCOL TYPE /AWS1/EL2PROTOCOLENUM /AWS1/EL2PROTOCOLENUM

The protocol the load balancer uses when performing health checks on targets. For Application Load Balancers, the default is HTTP. For Network Load Balancers and Gateway Load Balancers, the default is TCP. The TCP protocol is not supported for health checks if the protocol of the target group is HTTP or HTTPS. It 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.

IV_HEALTHCHECKPORT TYPE /AWS1/EL2HEALTHCHECKPORT /AWS1/EL2HEALTHCHECKPORT

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

IV_HEALTHCHECKPATH TYPE /AWS1/EL2PATH /AWS1/EL2PATH

[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 /Amazon Web Services.ALB/healthcheck.

IV_HEALTHCHECKENABLED TYPE /AWS1/EL2HEALTHCHECKENABLED /AWS1/EL2HEALTHCHECKENABLED

Indicates whether health checks are enabled.

IV_HEALTHCHECKINTERVALSECS TYPE /AWS1/EL2HEALTHCHECKINTERVAL00 /AWS1/EL2HEALTHCHECKINTERVAL00

The approximate amount of time, in seconds, between health checks of an individual target.

IV_HEALTHCHECKTIMEOUTSECONDS TYPE /AWS1/EL2HEALTHCHECKTMOUTSECS /AWS1/EL2HEALTHCHECKTMOUTSECS

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

IV_HEALTHYTHRESHOLDCOUNT TYPE /AWS1/EL2HEALTHCHECKTHRESHCNT /AWS1/EL2HEALTHCHECKTHRESHCNT

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

IV_UNHEALTHYTHRESHOLDCOUNT TYPE /AWS1/EL2HEALTHCHECKTHRESHCNT /AWS1/EL2HEALTHCHECKTHRESHCNT

The number of consecutive health check failures required before considering the target unhealthy.

IO_MATCHER TYPE REF TO /AWS1/CL_EL2MATCHER /AWS1/CL_EL2MATCHER

[HTTP/HTTPS health checks] The HTTP or gRPC codes to use when checking for a successful response from a target. For target groups with a protocol of TCP, TCP_UDP, UDP or TLS the range is 200-599. For target groups with a protocol of HTTP or HTTPS, the range is 200-499. For target groups with a protocol of GENEVE, the range is 200-399.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_EL2MDFYTGTGROUPOUTPUT /AWS1/CL_EL2MDFYTGTGROUPOUTPUT