CreateLoadBalancerHTTPListener

The name of this action.

Value: CreateLoadBalancerHTTPListener

Indicates whether to enable health checks.

Valid values: on | off

The frontend port used by the Server Load Balancer (SLB) instance.

Value range: 1 to 65535

The ID of the SLB instance.

The region to which the SLB instance belongs.

To query the region ID, refer to the list of regions and zones or call DescribeRegions.

Indicates whether to enable session persistence.

Valid values: on | off

The ID of the access control list associated with the listener.

If the value of the AclStatus parameter is on, this parameter is required.

Indicates whether to enable access control.

Valid values: on | off. Default value: off

The access control type. Valid values:

• white: Indicates a whitelist. Only requests from the IP addresses or CIDR blocks in the selected access control list are forwarded. It applies to scenarios where an application allows access only from specific IP addresses.

  Enabling a whitelist poses some risks to your services.

  After a whitelist is configured, only the IP addresses in the list can access the listener.

  If you enable a whitelist without adding any IP addresses in the list, all requests are forwarded.

• black: Indicates a blacklist. Requests from the IP addresses or CIDR blocks in the selected access control list are not forwarded (that is, they are blocked). It applies to scenarios where an application denies access only from specific IP addresses.

  If you enable a blacklist without adding any IP addresses to the list, all requests are forwarded.

If the value of the parameter AclStatus is on, this parameter is required.

The backend port used by the SLB instance.

Value range: 1 to 65535

The peak bandwidth of the listener. Valid values:

• -1: The peak bandwidth is not limited.
• 1 to 5120: the peak bandwidth of the listener. The sum of the peak bandwidth values of all listeners cannot surpass the peak bandwidth of the SLB instance.

The cookie configured on the backend server.

The cookie must be 1 to 200 characters in length and can only contain ASCII English letters and numbers. It cannot contain commas (,), semicolons (;), or spaces. Nor can it begin with a dollar sign ($).

If the value of the parameter StickySession is on and the value of the parameter StickySessionType is server, this parameter is required.

The timeout period of the cookie.

Valid values: 1 to 86400. Unit: seconds.

A description of the listener.

The description must be 1 to 80 characters in length and can contain letters, numbers, hyphens (-), forward slashes (/), periods (.), and underscores (_). Chinese characters are supported.

The port used for redirection from HTTP to HTTPS.

Indicates whether to enable Gzip compression to compress a specific file type. Default value: on

Valid values: on | off

The backend server port used for health checks.

Value range: 1 to 65535

The domain name used for health checks. Valid values:

• $_ip: the private IP address of the backend server. If the IP address is specified or this parameter is not specified, SLB uses the private IP addresses of backend servers as the domain names for health checks.
• domain: The domain name must be 1 to 80 characters in length, and can only contain letters, numbers, periods (.), and hyphens (-).

The HTTP status code indicating that the health check is normal. Separate multiple HTTP status codes by commas (,). Default value: http_2xx

Valid values: http_2xx | http_3xx | http_4xx | http_5xx

The interval between two consecutive health checks.

Value range: 1 to 50. Unit: seconds.

The amount of time to wait for a response from a health check. If the backend server does not send a correct response within the specified time, the health check fails.

Value range: 1 to 300. Unit: seconds.

The URL used for health checks.

The number of consecutive successes of health checks before a backend server is declared as healthy (from failure to success).

Value range: 2 to 10

The idle connection timeout. Value range: 1 to 60. Default value: 15. Unit: seconds.

If no request is received during the specified timeout period, SLB temporarily terminates the connection and restarts the connection when the next request is received.

Indicates whether to enable redirection from HTTP to HTTPS.

Valid values: on | off

The request timeout. Value range: 1 to 180. Default value: 60. Unit: seconds.

If the backend server does not respond within the specified timeout period, SLB stops waiting and returns an HTTP 504 error code to the client.

The algorithm used for distributing traffic. Valid values:

• wrr (default): A backend server with a higher weight receives more requests.
• wlc: A server with a higher weight receives more requests. When the weight values of two backend servers are the same, the server with a smaller number of connections is more likely to be polled.
• rr: Requests are evenly and sequentially distributed to backend servers.

The method used to handle the cookie. Valid values:

• insert: Insert a cookie.

  SLB adds a cookie to the first response from the backend server (that is, it inserts SERVERID in the HTTP/HTTPS response packet). Then, the next request contains the cookie and the listener distributes the request to the same backend server.

• server: Rewrite the cookie.

  SLB overwrites the original cookie when a new cookie is set. The next time the client carries the new cookie to access SLB, the listener distributes the request to the previously recorded backend server.

  Note If the value of the parameter StickySession is on, this parameter is required.

The number of consecutive failures of health checks before a backend server is declared as unhealthy (from success to failure).

Value range: 2 to 10

The ID of the VServer group associated with the listener.

Indicates whether to use the X-Forwarded-For header field to obtain the real IP address of a client. Default value: on

Valid values: on | off

Indicates whether to use the SLB-ID header field to obtain the SLB instance ID.

Valid values: on | off. Default value: off

Indicates whether to use the SLB-IP header field to obtain the real IP address of a client request.

Valid values: on | off. Default value: off

Indicates whether to use the X-Forwarded-Proto header field to obtain the listening protocol used by the SLB instance.

Valid values: on | off. Default value: off