HealthCheckTemplateProps
Properties for defining a HealthCheckTemplate.
See https://www.alibabacloud.com/help/ros/developer-reference/aliyun-alb-healthchecktemplate
Initializer
import com.aliyun.ros.cdk.alb.HealthCheckTemplateProps;
HealthCheckTemplateProps.builder()
.healthCheckTemplateName(java.lang.String)
.healthCheckTemplateName(IResolvable)
// .healthCheckCodes(IResolvable)
// .healthCheckCodes(java.util.List<java.lang.String)
// .healthCheckCodes(IResolvable>)
// .healthCheckConnectPort(java.lang.Number)
// .healthCheckConnectPort(IResolvable)
// .healthCheckHost(java.lang.String)
// .healthCheckHost(IResolvable)
// .healthCheckHttpVersion(java.lang.String)
// .healthCheckHttpVersion(IResolvable)
// .healthCheckInterval(java.lang.Number)
// .healthCheckInterval(IResolvable)
// .healthCheckMethod(java.lang.String)
// .healthCheckMethod(IResolvable)
// .healthCheckPath(java.lang.String)
// .healthCheckPath(IResolvable)
// .healthCheckProtocol(java.lang.String)
// .healthCheckProtocol(IResolvable)
// .healthCheckTimeout(java.lang.Number)
// .healthCheckTimeout(IResolvable)
// .healthyThreshold(java.lang.Number)
// .healthyThreshold(IResolvable)
// .resourceGroupId(java.lang.String)
// .resourceGroupId(IResolvable)
// .unhealthyThreshold(java.lang.Number)
// .unhealthyThreshold(IResolvable)
.build();
Properties
| Name | Type | Description |
|---|---|---|
healthCheckTemplateName | java.lang.String OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckTemplateName: The name of the health check template. |
healthCheckCodes | com.aliyun.ros.cdk.core.IResolvable OR java.util.List | Property healthCheckCodes: The HTTP status codes that indicate a successful health check. |
healthCheckConnectPort | java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckConnectPort: The port that is used for health checks. |
healthCheckHost | java.lang.String OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckHost: The domain name used for the health check. |
healthCheckHttpVersion | java.lang.String OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckHttpVersion: The HTTP version for health check protocol. |
healthCheckInterval | java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckInterval: The interval between two consecutive health checks. |
healthCheckMethod | java.lang.String OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckMethod: The method used for the health check. |
healthCheckPath | java.lang.String OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckPath: The URL that is used for health checks. |
healthCheckProtocol | java.lang.String OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckProtocol: The protocol used for the health check. |
healthCheckTimeout | java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable | Property healthCheckTimeout: The timeout period of a health check. |
healthyThreshold | java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable | Property healthyThreshold: The number of times that an unhealthy backend server must consecutively pass health checks before it is declared healthy. |
resourceGroupId | java.lang.String OR com.aliyun.ros.cdk.core.IResolvable | Property resourceGroupId: The ID of the resource group. |
unhealthyThreshold | java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable | Property unhealthyThreshold: The number of times that a healthy backend server must consecutively fail health checks before it is declared unhealthy. |
healthCheckTemplateNameRequired
public java.lang.Object getHealthCheckTemplateName();
- Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckTemplateName: The name of the health check template.
The name must be 2 to 128 characters in length, must start with a letter, a digit, or a Chinese character, and can contain digits, periods (.), underscores (_), hyphens (-), and spaces.
healthCheckCodesOptional
public java.lang.Object getHealthCheckCodes();
- Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List
Property healthCheckCodes: The HTTP status codes that indicate a successful health check.
healthCheckConnectPortOptional
public java.lang.Object getHealthCheckConnectPort();
- Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckConnectPort: The port that is used for health checks.
Valid values: 0 to 65535. Default value: 0. This value indicates that the port on a backend server is used for health checks.
healthCheckHostOptional
public java.lang.Object getHealthCheckHost();
- Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckHost: The domain name used for the health check.
Valid values:
- $SERVER_IP: The private IP address of a backend server. If you set this parameter to
$SERVER_IPor leave it empty, the load balancer uses the private IP address of the backend server as the domain name for the health check. - domain: The domain name must be 1 to 80 characters in length and can contain letters, digits, periods (.), and hyphens (-).
This parameter takes effect only when the
HealthCheckProtocolparameter is set to HTTP or HTTPS.
healthCheckHttpVersionOptional
public java.lang.Object getHealthCheckHttpVersion();
- Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckHttpVersion: The HTTP version for health check protocol.
Valid values: HTTP1.0 or HTTP1.1. Default value: HTTP 1.1. This parameter is available only when HealthCheckProtocol is set to HTTP or HTTPS.
healthCheckIntervalOptional
public java.lang.Object getHealthCheckInterval();
- Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckInterval: The interval between two consecutive health checks.
Unit: seconds. Valid values: 1 to 50. Default value: 2.
healthCheckMethodOptional
public java.lang.Object getHealthCheckMethod();
- Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckMethod: The method used for the health check.
Valid values:
- HEAD (default): For HTTP and HTTPS listeners, the default health check method is HEAD.
- POST: For gRPC listeners, the default health check method is POST.
- GET: If the response body exceeds 8 KB, it is truncated. This does not affect the health check result.
This parameter takes effect only when the
HealthCheckProtocolparameter is set to HTTP, HTTPS, or gRPC.
healthCheckPathOptional
public java.lang.Object getHealthCheckPath();
- Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckPath: The URL that is used for health checks.
The URL must be 1 to 80 characters in length. It must start with a forward slash (/) and can contain letters, digits, and the following special characters: - \/ . % ? # & _;~!()*[]@$^:',+.
This parameter takes effect only when the
HealthCheckProtocolparameter is set to HTTP or HTTPS.
healthCheckProtocolOptional
public java.lang.Object getHealthCheckProtocol();
- Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckProtocol: The protocol used for the health check.
Valid values:
- HTTP (default): simulates browser access by sending HEAD or GET requests to check whether the server application is healthy.
- HTTPS: simulates browser access by sending HEAD or GET requests to check whether the server application is healthy. HTTPS provides encrypted data transmission and is more secure than HTTP.
- TCP: checks whether the server port is responsive by sending SYN packets.
- gRPC: checks whether the server application is healthy by sending POST or GET requests.
healthCheckTimeoutOptional
public java.lang.Object getHealthCheckTimeout();
- Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable
Property healthCheckTimeout: The timeout period of a health check.
Unit: seconds. If a backend server does not respond within the specified timeout period, the backend server fails the health check. Valid values: 1 to 300. Default value: 5. Note If the value of the HealthCheckTimeout parameter is smaller than that of the HealthCheckInterval parameter, the timeout period specified by the HealthCheckTimeout parameter is ignored and the value of the HealthCheckInterval parameter is used as the timeout period.
healthyThresholdOptional
public java.lang.Object getHealthyThreshold();
- Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable
Property healthyThreshold: The number of times that an unhealthy backend server must consecutively pass health checks before it is declared healthy.
In this case, the health status is changed from fail to success. Valid values: 2 to 10. Default value: 3.
resourceGroupIdOptional
public java.lang.Object getResourceGroupId();
- Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable
Property resourceGroupId: The ID of the resource group.
unhealthyThresholdOptional
public java.lang.Object getUnhealthyThreshold();
- Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable
Property unhealthyThreshold: The number of times that a healthy backend server must consecutively fail health checks before it is declared unhealthy.
In this case, the health status is changed from success to fail. Valid values: 2 to 10. Default value: 3.