CreateLoadBalancerHTTPSListener

Description

call CreateLoadBalancerHTTPSListener to create HTTPS listeners.

Request Method

POST

Request Path

/apsara/route/Slb/CreateLoadBalancerHTTPSListener

Request Parameters Common Parameters

Name	Location	Type	Required	Sample value	Description
CookieTimeout	BODY	integer	No	500	Cookie timeout. value:1~86400 seconds. description when StickySession is on and StickySessionType is insert, this parameter is required.
VServerGroupId	BODY	string	No	rsp-cige6j5e7p****	server group ID.
Description	BODY	string	No	create listener	listen to description information. It is 1 to 80 characters in length and supports Chinese descriptions, as well as letters, numbers, dashes (-), forward slashes (/), periods (.), and underscores (_).
UnhealthyThreshold	BODY	integer	No	4	after how many consecutive health checks have failed, determine the health check status of the back-end server from success to fail. value:2~10. description in HealthCheck value is on is valid.
Scheduler	BODY	string	No	wrr	scheduling algorithm. Value: wrr(Default value): The backend server with the higher the weight value, the higher the number of times (probability) it is polled. wlc: In addition to polling according to the weight value set by each back-end server, the actual load of the back-end server (that is, the number of connections) is also considered. When the weight value is the same, the number of times (probability) that the backend server with the smaller the current number of connections is polled is higher. rr: distribute external requests to backend servers in sequence according to the access order.
HealthCheckURI	BODY	string	No	/test/index.html	URI for health check. is 1-80 characters in length and can only use letters, numbers and -/.%?#& amp;amp; these characters. The URL cannot only be a forward slash (/), but must start with a forward slash (/). description in HealthCheck value is on.
HealthCheck	BODY	string	Yes	on	whether to turn on health check. Value:on or off.
IdleTimeout	BODY	integer	No	12	specify the connection idle timeout time, the value range is 1~60 seconds, the default value is 15 seconds. /span>/p> p data-tag = "p" class = "p"> there has been no access request during the timeout period. load balancing will temporarily interrupt the current connection until the next request comes to temporarily re-establish a new connection.
LoadBalancerId	BODY	string	Yes	lb-bp1o94dp5i6earr****	load balancing instance ID.
BackendServerPort	BODY	integer	No	80	the port used by the backend of the load balancing instance, with the value:1~65535. this parameter is required if the server group is not used (VServerGroupId is not specified).
XForwardedFor_SLBID	BODY	string	No	on	whether to pass SLB-ID header field to obtain SLB instance ID. value:on or off (default value).
HealthCheckConnectPort	BODY	integer	No	8080	port used for health check. value:1~65535. description when HealthCheck value is on is valid.
Bandwidth	BODY	integer	Yes	-1	The peak bandwidth of the monitor, in Mbps. Value:-1 or 1~5120. -1: for public network load balancing instances charged by traffic, you can set the peak bandwidth to -1, that is, the peak bandwidth is not limited. 1~5120: for a public network load balancing instance that is billed by bandwidth, you can set the peak bandwidth of each listener, but the sum of the peak bandwidth of all listeners cannot exceed the peak bandwidth of the instance.
Gzip	BODY	string	No	on	Whether to turn on Gzip compression to compress specific file types. Value:on or off (default value).
ServerCertificateId	BODY	string	No	idkp-123-cn-test-****	server certificate ID.
StickySessionType	BODY	string	No	insert	Cookie processing method. This parameter must be specified when the StickySession value is on. value:insert or server. insert: insert cookies. /span>/p> p data-tag = "p" class = "p"> when the client accesses for the first time, load balancing will implant Cookie in the return request (I .e. insert ServerId in HTTP or HTTPS response message). next time the client carries this Cookie for access, the load balancing service will direct and forward the request to the previously recorded back-end server. server: rewrite Cookie. /span>/p> p data-tag = "p" class = "p"> load balancing finds that the user has customized the cookie and will rewrite the original cookie. next time the client accesses a new cookie, the load balancing service will direct the request to the previously recorded backend server.
XForwardedFor_SLBIP	BODY	string	No	on	whether to pass SLB-IP header field to obtain the real IP of the visitor. value:on or off (default value).
HealthCheckHttpCode	BODY	string	No	http_2xx	normal HTTP status code for health check, multiple status codes are divided by commas (,). The default value is http_2xx. value:http_2xx, http_3xx, http_4xx or http_5xx. description in HealthCheck value is on is valid.
Cookie	BODY	string	No	B490B5EBF6F3CD402E515D22BCDA1598	Cookie configured on the server. is 1 to 200 characters in length and can only contain ASCII English letters and numeric characters, cannot contain commas (,), semicolons (;) or spaces, and cannot start with dollar signs ($). description when StickySession is on and StickySessionType is server, this parameter is required.
ListenerPort	BODY	integer	Yes	80	the port used by the front end of the load balancing instance. value:1~65535.
RequestTimeout	BODY	integer	No	23	specify the request timeout time, the value range is 1~180 seconds, the default value is 60 seconds. /span>/p> p data-tag = "p" class = "p"> the back-end server has not responded during the timeout period. load balancing will give up waiting and return the HTTP 504 error code to the client.
HealthCheckInterval	BODY	integer	No	5	time interval for health check. Value:1~50(seconds). description in HealthCheck value is on is valid.
TLSCipherPolicy	BODY	string	No	tls_cipher_policy_1_1	Only performance guaranteed instances can specify TLSCipherPolicy parameters. Each policy defines 1 security policy. The security policy includes HTTPS optional TLS protocol version and supporting encryption algorithm suite. currently supports the following 4 security policies. please refer to the TLS security policy difference description for detailed differences. please select the corresponding policy according to the actual situation. < B data-tag=" B "class=" B ">tls_cipher_policy_1_0: Supports TLS versions: TLSv1.0, TLSv1.1 and TLSv1.2. supports encryption algorithm suites: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA256, AES256-SHA256, ECDHE-RSA-AES128-SHA, ECDHE-RSA-AES256-SHA, AES128-SHA, AES256-SHA, and DES-CBC3-SHA. < B data-tag=" B "class=" B ">tls_cipher_policy_1_1: Supports TLS versions: TLSv1.1 and TLSv1.2. supports encryption algorithm suites: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA256, AES256-SHA256, ECDHE-RSA-AES128-SHA, ECDHE-RSA-AES256-SHA, AES128-SHA, AES256-SHA, and DES-CBC3-SHA. < B data-tag=" B "class=" B ">tls_cipher_policy_1_2 Support TLS version: TLSv1.2. supports encryption algorithm suites: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA256, AES256-SHA256, ECDHE-RSA-AES128-SHA, ECDHE-RSA-AES256-SHA, AES128-SHA, AES256-SHA, and DES-CBC3-SHA. < B data-tag=" B "class=" B ">tls_cipher_policy_1_2_strict Support TLS version: TLSv1.2. supports encryption algorithm suites: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, ECDHE-RSA-AES128-SHA, and ECDHE-RSA-AES256-SHA.
CACertificateId	BODY	string	No	139a00604ad-cn-east-hangzh****	CA certificate ID. Two-way authentication: Upload both the CA certificate and the server certificate. One-way authentication: only upload server certificates.
HealthCheckTimeout	BODY	integer	No	3	the time to wait to receive the response from the health check. If the backend ECS does not respond correctly within the specified time, the health check is determined to have failed. In HealthCheck the value is on will only be valid. value:1~300 seconds. if HealthCHeckTimeout less than HealthCheckInterval, then HealthCHeckTimeout is invalid, the timeout period is HealthCheckInterval. description in HealthCheck value is on is valid.
version	BODY	string	No	2016-01-01	version of api
StickySession	BODY	string	Yes	on	whether to enable session persistence. Value:on or off.
regionId	BODY	string	Yes	No sample value for this parameter.	region id
HealthyThreshold	BODY	integer	No	4	after how many consecutive successful health checks, determine the health check status of the back-end server from failure to success . value:2~10. description in HealthCheck value is on is valid.
XForwardedFor	BODY	string	No	on	whether to pass X-Forwarded-For Get the real IP of the client request. value:on.
HealthCheckDomain	BODY	string	No	172.XX.XX.6	domain name for health check. Value: $_ ip: the private network IP of the backend server. When this parameter does not specify or specifies the private IP address of the backend server, SLB uses the private IP address of each backend server as the domain name for health check. domain: The length is 1 to 80 characters, and can only contain letters, numbers, English periods (.) and dashes (-). description in HealthCheck value is on.
XForwardedFor_proto	BODY	string	No	on	whether to pass X-Forwarded-Proto The header field obtains the listening protocol of the SLB. value:on or off (default value).

Return data

Name	Type	Sample value	Description
RequestId	string	CEF72CEB-54B6-4AE8-B225-F876FF7BA984	request ID.

Example

Successful Response example

{
 "RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

Failed Response example

{
 "errorSample":
 {
  "resultCode":-1,
  "resultMsg":"system error",
  "result":null
 }

}