Skip to main content

DescribeLoadBalancerHTTPListenerAttribute

Description

call DescribeLoadBalancerHTTPListenerAttribute to query HTTP listening configuration.

Request Method

POST

Request Path

/apsara/route/Slb/DescribeLoadBalancerHTTPListenerAttribute

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
ListenerPortBODYintegerYes80the port used by the front end of the load balancing instance. value:1~65535.
regionIdBODYstringYesNo sample value for this parameter.region id
LoadBalancerIdBODYstringYeslb-bp1o94dp5****ID of the load balancing instance.
versionBODYstringNo2016-01-01version of api
TagsBODYstringNo{"tagKey":"Key1","tagValue":"Value1"}tag key and value.

Return data

NameTypeSample valueDescription
CookieTimeoutinteger500Cookie timeout.
MaxConnectioninteger10Maximum number of connections.
VServerGroupIdstringrsp-cige6j****bound server group ID.
DescriptionstringtestHTTP listening description. It is 1 to 80 characters in length and supports Chinese descriptions, as well as letters, numbers, dashes (-), forward slashes (/), periods (.), and underscores (_).
UnhealthyThresholdinteger4unhealthy check threshold.
Schedulerstringwrrscheduling algorithm. Value:wrr, wlc or rr. 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.
HealthCheckURIstring/test/index.htmlURI for health check. /p> p data-tag = "p" class = "p"> span data-tag = "text" class = "text"> is limited to 1-80 characters in length and supports letters, numbers and dashes (-), forward slashes (/), half-angle period (.), percent sign (%), half-angle question mark (?), pound sign (#) and (& amp;) these characters. The URL cannot only be a forward slash (/), but must start with a forward slash (/). )
HealthCheckstringonwhether to turn on health check. Value:on or off.
IdleTimeoutinteger2specify 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.
BackendServerPortinteger80the port used by the backend of the load balancing instance.
XForwardedFor_SLBIDstringonwhether to pass SLB-ID header field to obtain the load balancing instance ID.
HealthCheckConnectPortinteger8080health check port. description when HealthCheck value is on is valid.
Bandwidthinteger-1The peak bandwidth of the monitor, in Mbps. Value: -1: no bandwidth peak value is limited. 1~5120: the peak bandwidth of listening, the sum of the peak bandwidth of all listeners cannot exceed the peak bandwidth of the instance. Description This parameter is only applicable to Mainland China.
SecurityStatusstringonsecurity status. Value:on or off.
GzipstringonWhether to turn on Gzip compression to compress specific file types. Value:on or off.
StickySessionTypestringinsertCookie processing method. Value:insert or server. insert: insert cookies. /ul> p data-tag = "p" class = "p"> when the client accesses for the first time, the load balancing service will insert a cookie into the return request (I .e. insert a ServerId into the HTTP or HTTPS response message). the next time the client carries this cookie for access, the load balancing service will directionally forward the request to the back-end server previously recorded. server: rewrite the cookie. /ul> 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 carries a new cookie to access, the load balancing service will directionally forward the request to the previously recorded back-end server. description when StickySession the value is on, this parameter must be specified.
XForwardedFor_SLBIPstringonwhether to pass SLB-IP header field obtains the real IP of the client request.
HealthCheckHttpCodestringhttp_2xxnormal HTTP status code for health check, multiple status codes are divided by commas (,). Value:http_2xx(default), http_3xx, http_4xx or http_5xx. description in HealthCheck value is on is valid.
Statusstringstoppedthe current status of listening. Value:running or stopped. running: indicates that the listening is running normally. stopped: Indicates that the listening is stopped.
CookiestringB490B5EBF6F3CD402E515D22BCDA1598Cookie configured on the server. 1 to 200 characters in length, can only contain ASCII English letters and numeric characters, cannot contain commas (,), semicolons (;) or spaces, and cannot start with the dollar sign ($).
ListenerPortinteger80the port used by the front end of the load balancing instance.
RequestTimeoutinteger34specify 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.
HealthCheckIntervalinteger5the time interval for health check, with a value of 1~50 seconds.
RequestIdstring365F4154-92F6-4AE4-92F8-7FF34B540710request ID.
HealthCheckTimeoutinteger3the maximum excess time of each health check response, with a value of 1~300 seconds.
ListenerForwardstringonindicates whether to enable HTTP to HTTPS listening and forwarding. on: indicates on. off: indicates that it is not turned on.
StickySessionstringonwhether to enable session persistence. Value:on or off(default value).
ForwardPortinteger80HTTP to HTTPS listening and forwarding port. description if ListenerForward the value is off, this parameter is not displayed.
HealthyThresholdinteger4health check threshold.
XForwardedForstringonwhether to turn on obtaining the real IP of visitors by X-Forwarded-For. Value:on or off.
HealthCheckDomainstringwww.domain.comdomain name used for health check.
XForwardedFor_protostringonwhether to pass X-Forwarded-Proto the header field obtains the listening protocol of the load balancing instance.

Example

Successful Response example

{
"CookieTimeout":"500",
"MaxConnection":"10",
"VServerGroupId":"rsp-cige6j****",
"Description":"test",
"UnhealthyThreshold":"4",
"Scheduler":"wrr",
"HealthCheckURI":"/test/index.html",
"HealthCheck":"on",
"IdleTimeout":"2",
"BackendServerPort":"80",
"XForwardedFor_SLBID":"on",
"HealthCheckConnectPort":"8080",
"Bandwidth":"-1",
"SecurityStatus":"on",
"Gzip":"on",
"StickySessionType":"insert",
"XForwardedFor_SLBIP":"on",
"HealthCheckHttpCode":"http_2xx",
"Status":"stopped",
"Cookie":"B490B5EBF6F3CD402E515D22BCDA1598",
"ListenerPort":"80",
"RequestTimeout":"34",
"HealthCheckInterval":"5",
"RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
"HealthCheckTimeout":"3",
"ListenerForward":"on",
"StickySession":"on",
"ForwardPort":"80",
"HealthyThreshold":"4",
"XForwardedFor":"on",
"HealthCheckDomain":"www.domain.com",
"XForwardedFor_proto":"on"
}

Failed Response example

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

}