All Products
Search
Document Center

Server Load Balancer:DescribeLoadBalancerListeners

Last Updated:Sep 24, 2026

Queries the details of SLB listeners.

Operation description

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

slb:DescribeLoadBalancerListeners

get

*LoadBalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

None None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

No

The region ID of the SLB instance.

You can invoke the DescribeRegions operation to query the region ID.

Note

If the endpoint of the selected region is slb.aliyuncs.com, the RegionId parameter is required.

cn-hangzhou

NextToken

string

No

The token that determines the start point of the next query. Valid values:

  • If this is the first query or no subsequent query is to be sent, you do not need to specify this parameter.

  • If a subsequent query is to be sent, set the value to the NextToken value returned in the previous API call.

FFmyTO70tTpLG6I3FmYAXGKPd****

MaxResults

integer

No

The number of entries per page in a paginated query.

Valid values: 1 to 100. If this parameter is not specified, the default value is 20.

50

ListenerProtocol

string

No

The Server Load Balancer (SLB) listener protocol. Valid values:

  • tcp

  • udp

  • http

  • https

http

LoadBalancerId

array

No

The list of Server Load Balancer (SLB) instance IDs. A maximum of 10 instance IDs are supported.

Note

For non-SDK calls, use the LoadBalancerId.N format to specify this parameter.

lb-123wrwer

string

No

The ID of the SLB instance.

lb-uf6so8u4g35prnvsw****

Tag

array<object>

No

The tags.

object

No

The tags.

Key

string

No

The tag key of the resource. Valid values of N: 1 to 20. The tag key cannot be an empty string.

The tag key can be up to 64 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://.

TestKey

Value

string

No

The tag value of the resource. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://.

TestValue

ListenerPort

integer

No

The listener port of the CLB instance.

443

Description

string

No

The custom listener name.

HTTPS_443

Response elements

Element

Type

Description

Example

object

Listeners

array<object>

The list of listeners of the Classic Load Balancer (CLB) instance.

Note

This parameter is not returned if no listeners are configured for the instance.

array<object>

The list of listeners of the Classic Load Balancer (CLB) instance.

Note

This parameter is not returned if no listeners are configured for the instance.

AclId

string

The ID of the access control policy group.

acl-a2do9e413e0spzasx****

AclIds

array

The list of access control policy group IDs.

string

The ID of the access control policy group.

acl-a2do9e413e0spzasx****

AclStatus

string

Indicates whether access control is enabled. Valid values:

  • on: enabled.

  • off: disabled.

off

AclType

string

The type of access control. Valid values:

  • white: Only requests from the IP addresses or CIDR blocks in the selected access control policy group are forwarded. The whitelist is applicable to scenarios where you want to allow only specific IP addresses to access the SLB listener.

If a whitelist is enabled but no IP addresses are added to the access control policy group, the SLB listener forwards all requests.

  • black: All requests from the IP addresses or CIDR blocks in the selected access control policy group are blocked. The blacklist is applicable to scenarios where you want to block specific IP addresses from accessing the SLB listener.

If a blacklist is enabled but no IP addresses are added to the access control policy group, the SLB listener forwards all requests.

white

BackendServerPort

integer

The port of the backend server.

Note

This parameter takes effect only when both VServerGroupId and MasterSlaveServerGroupId are empty.

80

Bandwidth

integer

The peak bandwidth of the listener. Unit: Mbit/s.

-1

Description

string

The description of the listener.

test

HTTPListenerConfig

object

The HTTP listener configuration.

Cookie

string

The cookie configured on the server.

B490B5EBF6F3CD402E515D22BCDA****

CookieTimeout

integer

The cookie timeout period. Unit: seconds.

Valid values: 1 to 86400.

500

ForwardPort

integer

The listening port used to redirect HTTP requests to HTTPS.

Note

This parameter is not displayed if ListenerForward is set to off.

80

Gzip

string

Indicates whether Gzip compression is enabled. Valid values:

  • on: enabled.

  • off: disabled.

on

HealthCheck

string

Indicates whether health checks are enabled. Valid values:

  • on: enabled.

  • off: disabled.

on

HealthCheckConnectPort

integer

The port used for health checks.

Note

This parameter takes effect only when HealthCheck is set to on.

8080

HealthCheckDomain

string

The domain name used for health checks.

www.example.com

HealthCheckHttpCode

string

The HTTP status code that indicates a Normal health check result.

http_2xx,http_3xx

HealthCheckHttpVersion

string

The HTTP version used for health checks.

HTTP 1.0

HealthCheckInterval

integer

The interval between two consecutive health checks. Unit: seconds.

5

HealthCheckMethod

string

The health check method. Valid values: head or get.

get

HealthCheckTimeout

integer

The maximum timeout period for each health check response. Unit: seconds.

3

HealthCheckType

string

The health check protocol.

tcp

HealthCheckURI

string

The URI used for health checks.

/test/index.html

HealthyThreshold

integer

The number of consecutive successful health checks required before the health check status of a backend server changes from fail to success.

Valid values: 2 to 10.

4

IdleTimeout

integer

The idle connection timeout period. Unit: seconds. Valid values: 1 to 60.

If no request is received within the timeout period, Server Load Balancer temporarily closes the connection and re-establishes the connection when the next request arrives.

15

ListenerForward

string

Indicates whether HTTP-to-HTTPS redirection is enabled for the listener. Valid values:

  • on: enabled.

  • off: disabled.

on

RequestTimeout

integer

The request timeout period. Unit: seconds. Valid values: 1 to 180.

If no response is received from the backend server within the timeout period, Server Load Balancer stops waiting and returns an HTTP 504 error code to the client.

60

StickySession

string

Indicates whether session persistence is enabled. Valid values:

  • on: enabled.

  • off: disabled.

on

StickySessionType

string

The method used to handle cookies. Valid values:

  • insert: Insert cookie. When a client sends a request for the first time, Server Load Balancer inserts a cookie into the response (inserts SERVERID into the HTTP and HTTPS response). The next time the client sends a request with this cookie, Server Load Balancer forwards the request to the previously recorded backend server.

  • server: Rewrite cookie. When Server Load Balancer detects a user-defined cookie, it rewrites the original cookie. The next time the client sends a request with the new cookie, Server Load Balancer forwards the request to the previously recorded backend server.

insert

UnhealthyThreshold

integer

The number of consecutive failed health checks required before the health check status of a backend server changes from success to fail.

Valid values: 2 to 10.

4

XForwardedFor

string

Indicates whether the XForwardedFor header is used to retrieve the originating IP address of the client. Valid values:

  • on: enabled.

  • off: disabled.

on

XForwardedFor_ClientSrcPort

string

Indicates whether the XForwardedFor_ClientSrcPort header is used to retrieve the port of the client that accesses the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

on

XForwardedFor_SLBID

string

Indicates whether the SLB-ID header is used to retrieve the ID of the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

on

XForwardedFor_SLBIP

string

Indicates whether the SLB-IP header is used to retrieve the virtual IP address (VIP) of the client request. Valid values:

  • on: enabled.

  • off: disabled.

on

XForwardedFor_SLBPORT

string

Indicates whether the XForwardedFor_SLBPORT header is used to retrieve the listener port of the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

on

XForwardedFor_proto

string

Indicates whether the X-Forwarded-Proto header is used to retrieve the listener protocol of the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

on

HTTPSListenerConfig

object

The HTTPS listener configuration.

CACertificateId

string

The ID of the CA certificate.

idkp-234-cn-test-0****

Cookie

string

The cookie configured on the server.

B490B5EBF6F3CD402E515D22BCDA****

CookieTimeout

integer

The cookie timeout period. Unit: seconds.

Valid values: 1 to 86400.

500

EnableHttp2

string

Indicates whether HTTP 2.0 is enabled. Valid values:

  • on: enabled.

  • off: disabled.

off

Gzip

string

Indicates whether Gzip compression is enabled. Valid values:

  • on: enabled.

  • off: disabled.

on

HealthCheck

string

Indicates whether health checks are enabled. Valid values:

  • on: enabled.

  • off: disabled.

on

HealthCheckConnectPort

integer

The port used for health checks.

8080

HealthCheckDomain

string

The domain name used for health checks.

www.example.com

HealthCheckHttpCode

string

The HTTP status code that indicates a Normal health check result.

http_2xx,http_3xx

HealthCheckHttpVersion

string

The HTTP version used for health checks.

HTTP 1.0

HealthCheckInterval

integer

The interval between two consecutive health checks. Unit: seconds.

5

HealthCheckMethod

string

The health check method.

get

HealthCheckTimeout

integer

The maximum timeout period for each health check response. Unit: seconds.

3

HealthCheckType

string

The health check protocol.

tcp

HealthCheckURI

string

The URI used for health checks.

/test/index.html

HealthyThreshold

integer

The number of consecutive successful health checks required before the health check status of a backend server changes from fail to success.

Valid values: 2 to 10.

4

IdleTimeout

integer

The idle connection timeout period. Unit: seconds. Valid values: 1 to 60.

If no request is received within the timeout period, Server Load Balancer temporarily closes the connection and re-establishes the connection when the next request arrives.

15

RequestTimeout

integer

The request timeout period. Unit: seconds. Valid values: 1 to 180.

If no response is received from the backend server within the timeout period, Server Load Balancer stops waiting and returns an HTTP 504 error code to the client.

60

ServerCertificateId

string

The ID of the server certificate.

idkp-123-cn-test-0****

StickySession

string

Indicates whether session persistence is enabled. Valid values:

  • on: enabled.

  • off: disabled.

on

StickySessionType

string

The method used to handle cookies.

  • insert: Insert cookie. When a client sends a request for the first time, Server Load Balancer inserts a cookie into the response (inserts SERVERID into the HTTP and HTTPS response). The next time the client sends a request with this cookie, Server Load Balancer forwards the request to the previously recorded backend server.

  • server: Rewrite cookie. When Server Load Balancer detects a user-defined cookie, it rewrites the original cookie. The next time the client sends a request with the new cookie, Server Load Balancer forwards the request to the previously recorded backend server.

insert

TLSCipherPolicy

string

The security policy that contains the TLS protocol versions and supported encryption algorithm suites for HTTPS.

  • tls_cipher_policy_1_0:

    Supported TLS versions: TLSv1.0, TLSv1.1, and TLSv1.2.

    Supported 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.

  • tls_cipher_policy_1_1:

    Supported TLS versions: TLSv1.1 and TLSv1.2.

    Supported 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.

  • tls_cipher_policy_1_2

    Supported TLS versions: TLSv1.2.

    Supported 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.

  • tls_cipher_policy_1_2_strict

    Supported TLS versions: TLSv1.2.

    Supported 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.

  • tls_cipher_policy_1_2_strict_with_1_3

    Supported TLS versions: TLSv1.2 and TLSv1.3.

    Supported encryption algorithm suites: TLS_AES_128_GCM_SHA256, TLS_AES_256_GCM_SHA384, TLS_CHACHA20_POLY1305_SHA256, TLS_AES_128_CCM_SHA256, TLS_AES_128_CCM_8_SHA256, ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES128-SHA256, ECDHE-ECDSA-AES256-SHA384, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, ECDHE-ECDSA-AES128-SHA, ECDHE-ECDSA-AES256-SHA, ECDHE-RSA-AES128-SHA, and ECDHE-RSA-AES256-SHA.

tls_cipher_policy_1_0

UnhealthyThreshold

integer

The number of consecutive failed health checks required before the health check status of a backend server changes from success to fail.

Valid values: 2 to 10.

4

XForwardedFor

string

Indicates whether the XForwardedFor header is used to retrieve the originating IP address of the client. Valid values:

  • on: enabled.

  • off: disabled.

on

XForwardedFor_ClientCertClientVerify

string

Indicates whether the XForwardedFor_ClientCertClientVerify header is used to retrieve the verification result of the client certificate that accesses the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

off

XForwardedFor_ClientCertFingerprint

string

Indicates whether the XForwardedFor_ClientCertFingerprint header is used to retrieve the fingerprint of the client certificate that accesses the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

off

XForwardedFor_ClientCertIssuerDN

string

Indicates whether the XForwardedFor_ClientCertIssuerDN header is used to retrieve the issuer information of the client certificate that accesses the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

off

XForwardedFor_ClientCertSubjectDN

string

Indicates whether the XForwardedFor_ClientCertSubjectDN header is used to retrieve the owner information of the client certificate that accesses the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

off

XForwardedFor_ClientSrcPort

string

Indicates whether the XForwardedFor_ClientSrcPort header is used to retrieve the port of the client that accesses the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

off

XForwardedFor_SLBID

string

Indicates whether the SLB-ID header is used to retrieve the ID of the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

on

XForwardedFor_SLBIP

string

Indicates whether the SLB-IP header is used to retrieve the virtual IP address (VIP) of the client request. Valid values:

  • on: enabled.

  • off: disabled.

on

XForwardedFor_SLBPORT

string

Indicates whether the XForwardedFor_SLBPORT header is used to retrieve the listener port of the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

off

XForwardedFor_proto

string

Indicates whether the X-Forwarded-Proto header is used to retrieve the listener protocol of the SLB instance. Valid values:

  • on: enabled.

  • off: disabled.

on

ListenerPort

integer

The listening port.

80

ListenerProtocol

string

The listener protocol of the Classic Load Balancer (CLB) instance.

http

LoadBalancerId

string

The ID of the Classic Load Balancer (CLB) instance.

lb-bp1b6c719dfa****

Scheduler

string

The scheduling algorithm. Valid values:

  • wrr: Backend servers with higher weights receive more requests (higher probability) in each polling cycle.

  • rr: Requests are distributed to backend servers in sequence based on the access order.

  • sch: Consistent hashing based on source IP addresses. Requests from the same source IP address are distributed to the same backend server.

  • tch: Consistent hashing based on four factors (source IP address, destination IP address, source port, and destination port). Requests from the same flow are distributed to the same backend server.

  • qch: Consistent hashing based on QUIC Connection ID. Requests with the same QUIC Connection ID are distributed to the same backend server.

Note

Only guaranteed-performance instances support the sch, tch, and qch consistent hashing algorithms.

wrr

Status

string

The status of the listener. Valid values:

  • running: The listener is running.

  • stopped: The listener is stopped.

running

TCPListenerConfig

object

The TCP listener configuration.

ConnectionDrain

string

Indicates whether connection draining is enabled. Valid values:

  • on: enabled.

  • off: disabled.

off

ConnectionDrainTimeout

integer

The connection draining timeout period. Unit: seconds.

Valid values: 10 to 900.

300

EstablishedTimeout

integer

The connection timeout period. Unit: seconds.

500

HealthCheck

string

Indicates whether health checks are enabled. Valid values:

  • on: enabled.

  • off: disabled.

on

HealthCheckConnectPort

integer

The port used for health checks.

8080

HealthCheckConnectTimeout

integer

The health check timeout period. Unit: seconds.

Valid values: 1 to 300.

100

HealthCheckDomain

string

The domain name used for health checks.

www.example.com

HealthCheckHttpCode

string

The HTTP status code that indicates a healthy health check.

http_2xx,http_3xx

HealthCheckInterval

integer

The interval between two consecutive health checks. Unit: seconds.

5

HealthCheckMethod

string

The health check method.

get

HealthCheckType

string

The health check protocol.

tcp

HealthCheckURI

string

The URI used for health checks.

/test/index.html

HealthyThreshold

integer

The number of consecutive successful health checks required before the health check status of a backend server changes from fail to success.

Valid values: 2 to 10.

4

MasterSlaveServerGroupId

string

The ID of the primary/secondary server group associated with the listener.

rsp-0bfucw*****

PersistenceTimeout

integer

Indicates whether session persistence is enabled. Unit: seconds.

Valid values: 0 to 3600.

A value of 0 indicates that session persistence is not enabled.

0

ProxyProtocolV2Enabled

string

Indicates whether the Proxy Protocol is used to carry the client source address to the backend server. Valid values:

  • true: Enabled.

  • false: Disabled.

false

UnhealthyThreshold

integer

The number of consecutive failed health checks required before the health check status of a backend server changes from success to fail.

Valid values: 2 to 10.

4

Tags

array<object>

The tags.

object

The tags.

TagKey

string

The tag key of the resource.

TestKey

TagValue

string

The tag value of the resource.

TestValue

UDPListenerConfig

object

The UDP listener configuration.

ConnectionDrain

string

Indicates whether connection draining is enabled. Valid values:

  • on: enabled.

  • off: disabled.

off

ConnectionDrainTimeout

integer

The connection draining timeout period. Unit: seconds.

Valid values: 10 to 900.

300

HealthCheck

string

Indicates whether health checks are enabled. Valid values:

  • on: enabled.

  • off: disabled.

on

HealthCheckConnectPort

integer

The port used for health checks.

8080

HealthCheckConnectTimeout

integer

The health check response timeout period.

100

HealthCheckExp

string

The response string for UDP listener health checks.

ok

HealthCheckInterval

integer

The interval between two consecutive health checks. Unit: seconds.

5

HealthCheckReq

string

The request string for UDP listener health checks.

hello

HealthyThreshold

integer

The health check healthy threshold.

4

MasterSlaveServerGroupId

string

The ID of the associated primary/secondary server group.

rsp-0bfucw****

ProxyProtocolV2Enabled

string

Indicates whether the Proxy Protocol is used to carry the client source address to the backend server. Valid values:

  • true: Enabled.

  • false: Disabled.

false

UnhealthyThreshold

integer

The health check unhealthy threshold.

4

VServerGroupId

string

The ID of the virtual server group associated with the listener.

rsp-cige6j****

MaxResults

integer

The number of entries returned per page in a paginated query.

50

NextToken

string

Indicates whether a next query token exists. Valid values:

  • If NextToken is empty, no next query exists.

  • If NextToken is returned, the value indicates the token for the next query.

FFmyTO70tTpLG6I3FmYAXGKPd****

RequestId

string

The request ID.

365F4154-92F6-4AE4-92F8-7FF34B540710

TotalCount

integer

The total number of entries returned under the current query conditions.

10

Examples

Success response

JSON format

{
  "Listeners": [
    {
      "AclId": "acl-a2do9e413e0spzasx****",
      "AclIds": [
        "acl-a2do9e413e0spzasx****"
      ],
      "AclStatus": "off",
      "AclType": "white",
      "BackendServerPort": 80,
      "Bandwidth": -1,
      "Description": "test",
      "HTTPListenerConfig": {
        "Cookie": "B490B5EBF6F3CD402E515D22BCDA****",
        "CookieTimeout": 500,
        "ForwardPort": 80,
        "Gzip": "on",
        "HealthCheck": "on",
        "HealthCheckConnectPort": 8080,
        "HealthCheckDomain": "www.example.com",
        "HealthCheckHttpCode": "http_2xx,http_3xx",
        "HealthCheckHttpVersion": "HTTP 1.0",
        "HealthCheckInterval": 5,
        "HealthCheckMethod": "get",
        "HealthCheckTimeout": 3,
        "HealthCheckType": "tcp",
        "HealthCheckURI": "/test/index.html",
        "HealthyThreshold": 4,
        "IdleTimeout": 15,
        "ListenerForward": "on",
        "RequestTimeout": 60,
        "StickySession": "on",
        "StickySessionType": "insert",
        "UnhealthyThreshold": 4,
        "XForwardedFor": "on",
        "XForwardedFor_ClientSrcPort": "on",
        "XForwardedFor_SLBID": "on",
        "XForwardedFor_SLBIP": "on",
        "XForwardedFor_SLBPORT": "on",
        "XForwardedFor_proto": "on"
      },
      "HTTPSListenerConfig": {
        "CACertificateId": "idkp-234-cn-test-0****",
        "Cookie": "B490B5EBF6F3CD402E515D22BCDA****",
        "CookieTimeout": 500,
        "EnableHttp2": "off",
        "Gzip": "on",
        "HealthCheck": "on",
        "HealthCheckConnectPort": 8080,
        "HealthCheckDomain": "www.example.com",
        "HealthCheckHttpCode": "http_2xx,http_3xx",
        "HealthCheckHttpVersion": "HTTP 1.0",
        "HealthCheckInterval": 5,
        "HealthCheckMethod": "get",
        "HealthCheckTimeout": 3,
        "HealthCheckType": "tcp",
        "HealthCheckURI": "/test/index.html",
        "HealthyThreshold": 4,
        "IdleTimeout": 15,
        "RequestTimeout": 60,
        "ServerCertificateId": "idkp-123-cn-test-0****",
        "StickySession": "on",
        "StickySessionType": "insert",
        "TLSCipherPolicy": "tls_cipher_policy_1_0",
        "UnhealthyThreshold": 4,
        "XForwardedFor": "on",
        "XForwardedFor_ClientCertClientVerify": "off",
        "XForwardedFor_ClientCertFingerprint": "off",
        "XForwardedFor_ClientCertIssuerDN": "off",
        "XForwardedFor_ClientCertSubjectDN": "off",
        "XForwardedFor_ClientSrcPort": "off",
        "XForwardedFor_SLBID": "on",
        "XForwardedFor_SLBIP": "on",
        "XForwardedFor_SLBPORT": "off",
        "XForwardedFor_proto": "on"
      },
      "ListenerPort": 80,
      "ListenerProtocol": "http",
      "LoadBalancerId": "lb-bp1b6c719dfa****",
      "Scheduler": "wrr",
      "Status": "running",
      "TCPListenerConfig": {
        "ConnectionDrain": "off",
        "ConnectionDrainTimeout": 300,
        "EstablishedTimeout": 500,
        "HealthCheck": "on",
        "HealthCheckConnectPort": 8080,
        "HealthCheckConnectTimeout": 100,
        "HealthCheckDomain": "www.example.com",
        "HealthCheckHttpCode": "http_2xx,http_3xx",
        "HealthCheckInterval": 5,
        "HealthCheckMethod": "get",
        "HealthCheckType": "tcp",
        "HealthCheckURI": "/test/index.html",
        "HealthyThreshold": 4,
        "MasterSlaveServerGroupId": "rsp-0bfucw*****",
        "PersistenceTimeout": 0,
        "ProxyProtocolV2Enabled": "false",
        "UnhealthyThreshold": 4
      },
      "Tags": [
        {
          "TagKey": "TestKey",
          "TagValue": "TestValue"
        }
      ],
      "UDPListenerConfig": {
        "ConnectionDrain": "off",
        "ConnectionDrainTimeout": 300,
        "HealthCheck": "on",
        "HealthCheckConnectPort": 8080,
        "HealthCheckConnectTimeout": 100,
        "HealthCheckExp": "ok",
        "HealthCheckInterval": 5,
        "HealthCheckReq": "hello",
        "HealthyThreshold": 4,
        "MasterSlaveServerGroupId": "rsp-0bfucw****",
        "ProxyProtocolV2Enabled": "false",
        "UnhealthyThreshold": 4
      },
      "VServerGroupId": "rsp-cige6j****"
    }
  ],
  "MaxResults": 50,
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "TotalCount": 10
}

Error codes

HTTP status code

Error code

Error message

Description

400 IllegalParam.ListenerProtocol The param of ListenerProtocol is illegal. The specified ListenerProtocol is invalid. Check the parameter constraints and try again.
400 IllegalParam.MaxResults The param of MaxResults is illegal. The specified MaxResults is invalid. Check the parameter constraints and try again.
400 IllegalParam.NextToken The param of NextToken is illegal. The specified NextToken is invalid. Check the parameter constraints and try again.
400 IllegalParamSize.LoadBalancerId The param size of LoadBalancerId is illegal. The specified LoadBalancerId is invalid. Check the parameter constraints and try again.
400 MissingParam.TagKey The param of TagKey is missing.
403 UnauthorizedRegion The specified region of is not authorized. The specified region of is not authorized.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.