You need to enable JavaScript to run this app.
导航

DescribeListenerAttributes

最近更新时间2023.11.16 15:51:40

首次发布时间2021.08.31 10:37:27

调用 DescribeListenerAttributes 接口查询指定监听器的详细信息。

调试

请求参数

名称类型是否必填示例值
描述
ActionStringDescribeListenerAttributes要执行的操作,取值为DescribeListenerAttributes。
VersionString2020-04-01API版本信息,当前版本为:2020-04-01。
ListenerIdStringlsn-2fek3rgsxhrsw5oxruwec****监听器的ID。您可以调用DescribeListeners接口获取监听器ID。

返回数据

字段类型示例值
描述
RequestIdString20210811152539010225146063030****请求ID。
ListenerIdStringlsn-2fek3rgsxhrsw5oxruwec****监听器的ID。
ListenerNameStringmylistener监听器的名称。
CreateTimeString2021-08-11T16:37:37Z监听器的创建时间。
UpdateTimeString2021-08-11T16:37:37Z监听器的最近操作时间。
LoadBalancerIdStringclb-bp1o94dp5i6ea****监听器所属的负载均衡实例ID。

Status

String

Active

监听器的状态。

  • Creating:创建中。
  • Active:运行中。
  • Deleting: 删除中。
  • Disabled: 已停用。

Enabled

String

off

是否启用监听器。

  • on:开启。
  • off:不开启。

EstablishedTimeout

Integer

100

监听器的连接超时时间。

说明

仅TCP/UDP监听器会返回本参数。

Protocol

String

TCP

监听器的协议。

  • TCP
  • UDP
  • HTTP
  • HTTPS

ProxyProtocolType

String

off

是否启用PP协议。

  • off:关闭。
  • standard:开启。

PersistenceType

String

off

会话保持的类型。

  • off:表示不启用会话保持。
  • source_ip:表示源地址IP。
PersistenceTimeoutInteger10会话保持的超时时间,单位为秒。

ConnectionDrainEnabled

String

on

监听器是否开启连接优雅中断功能。

  • on:开启。
  • off:不开启。

说明

参数Protocol返回为HTTP或HTTPS时,该参数固定返回off。

ConnectionDrainTimeout

Integer

2

连接优雅中断的超时时间,单位为秒。

说明

参数ConnectionDrainEnabled返回为off时,该参数返回0。

PortInteger80监听器接收请求使用的端口。

Scheduler

String

wrr

监听器使用的调度算法。

  • wrr (默认值):加权轮询,权重值越高的后端服务器,被轮询到的次数(概率)越高。
  • wlc:加权最小连接数,在最少连接数的基础上,根据服务器的不同处理能力,给每个服务器分配不同的权重,使其能够接受相应权值数的服务请求。
  • sh:源地址哈希,基于源IP地址的一致性哈希,相同的源地址会调度到相同的后端服务器。
HealthCheck--健康检查相关信息。具体请参见下表“ HealthCheck ”。
ServerGroupIdStringrsp-bp1o94dp5i6ea****TCP/UDP监听器关联的后端服务器组的ID。HTTP/HTTPS监听器关联的默认后端服务器组ID。

AclStatus

String

off

是否开启访问控制功能。

  • on:开启。
  • off :不开启。

AclType

String

black

访问控制的方式。

  • white :白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。
  • black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。如果所选策略组中没有添加任何IP,则监听器会转发全部请求。

说明

AclStatus参数为 on 时返回。

Bandwidth

Integer

10

监听器的带宽峰值,单位为Mbps。
返回为-1,表示监听器不指定限速。此时监听器的带宽峰值默认为CLB实例规格的剩余带宽。

AclIds

Array of String

["acl-2fe5excqgk6ww5oxruvcv****","acl-2febxt4pu0zy85oxruw0t****"]

监听器绑定的访问控制策略组ID。

说明

AclStatus参数为 on 时返回。

DescriptionStringtest监听器的描述。
CertificateIdStringcert-bp1o94dp5i6ea****HTTPS监听器关联的证书ID。

HealthCheck

字段类型示例值
描述

Enabled

String

off

监听器是否开启健康检查功能。

  • on :开启。
  • off:不开启。

UdpRequest

String

Request123

执行健康检查的请求字符串。
仅当UDP监听器指定请求字符串时返回该参数。

UdpExpect

String

Expect123

健康检查的预期响应字符串。
仅当UDP监听器指定请求字符串时返回该参数。

IntervalInteger2执行健康检查的时间间隔。
TimeoutInteger2健康检查的响应超时时间,表示如果后端服务器在指定的时间内没有正确响应,则判定为健康检查异常。
HealthyThresholdInteger3健康检查的健康阈值,表示连续执行指定次数的健康检查,结果均为“正常”的后端服务器将被判定为健康检查“正常”。
UnHealthyThresholdInteger3健康检查的不健康阈值,表示连续执行指定次数的健康检查,结果均为“异常”的后端服务器将被判定为健康检查“异常”。

Method

String

GET

监听器健康检查的方法。

  • GET:服务器需支持GET方法。
  • HEAD:服务器仅返回HEAD头部信息,可以降低后端开销,但要求服务器支持HEAD方法。

说明

TCP/UDP监听器不返回该参数。

Uri

String

/

健康检查的路径。

说明

TCP/UDP监听器不返回该参数。

Domain

String

www.test.com

健康检查的域名。

说明

TCP/UDP监听器不返回该参数。

HttpCode

String

http_2xx

健康检查正常的HTTP状态码。

  • http_2xx
  • http_3xx
  • http_4xx
  • http_5xx

说明

TCP/UDP监听器不返回该参数。

请求示例

GET /?Action=DescribeLstenerAttributes&Version=2020-04-01&ListenerId=lsn-2fek3rgsxhrsw5oxruwec**** HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: clb

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20210811152539010225146063030****",
        "Action": "DescribeListenerAttributes",
        "Version": "2020-04-01",
        "Service": "clb",
        "Region": "cn-beijing"
    },     
     "Result": {
        "RequestId": "20210811152539010225146063030****",
        "CreateTime": "2021-08-14T14:55:04Z",
        "UpdateTime": "2021-08-14T14:55:04Z",
        "LoadBalancerId": "clb-bp1o94dp5i6ea****",
        "ListenerId": "lsn-2fek3rgsxhrsw5oxruwec****",
        "ListenerName": "api-test",
        "Description": "",
        "Status": "Creating",
        "Protocol": "HTTPS",
        "ProxyProtocolType": "off",
        "PersistenceType": "off",
        "PersistenceTimeout": 0,
        "ConnectionDrainEnabled": "off",
        "ConnectionDrainTimeout": 0,
        "Port": 1212,
        "Scheduler": "wrr",
        "Enabled": "on",
        "ServerGroupId": "rsp-bp1o94dp5i6ea****",
        "AclStatus": "on",
        "AclType": "black",
        "Bandwidth": -1,
        "AclIds": [
            "acl-2fe5excqgk6ww5oxruvcv****",
            "acl-2febxt4pu0zy85oxruw0t****"
        ],
        "EstablishedTimeout": 122,
        "CertificateId": "cert-bp1o94dp5i6ea****",
        "HealthCheck": {
            "Enabled": "on",
            "Interval": 2,
            "HealthyThreshold": 2,
            "UnHealthyThreshold": 2,
            "Timeout": 2,
            "Method": "GET",
            "Domain": "test",
            "Uri": "/www.abc.com",
            "HttpCode": "http_3xx"
        }
    }
}

错误码

此处仅展示当前API的错误码,更多错误码请参见公共错误码

HttpCode错误码错误信息描述

400

MissingParameter

The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'XXX'.

该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如XXX

说明

其中,XXX表示缺少的参数名称。

404InvalidListener.NotFoundThe specified Listener does not exist.指定的监听器不存在。