文档

ListListeners - 查询监听

更新时间:

查询指定地域的监听。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
alb:ListListenersRead
  • LoadBalancer
    acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

请求参数

名称类型必填描述示例值
NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次 API 调用返回的 NextToken 值。
FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResultsinteger

本次读取的最大数据记录数量,此参数为可选参数。取值范围:1~100。入参为空时,默认值为 20

50
ListenerIdsarray

监听实例 ID 列表。最多支持 20 个监听 ID。

string

监听实例 ID。最多支持 20 个监听 ID。

lsn-o4u54y73wq7b******
LoadBalancerIdsarray

应用型负载均衡实例 ID。最多支持 20 个实例 ID。

string

应用型负载均衡实例 ID。最多支持 20 个实例 ID。

alb-bd6oylbckp6k9x****
ListenerProtocolstring

需要过滤的监听协议。取值:

  • HTTP:协议类型为 HTTP。
  • HTTPS:协议类型为 HTTPS。
  • QUIC:协议类型为 QUIC。
HTTP
Tagobject []

标签。

Keystring

标签键。最多支持 128 个字符,不能以 aliyun 或 acs:开头,不能包含 http://或 https://。

env
Valuestring

标签值。最多支持 128 个字符,不能以 aliyun 或 acs:开头,不能包含 http://或 https://。

product

返回参数

名称类型描述示例值
object

应用型负载均衡监听信息。

Listenersobject []

应用型负载均衡监听列表。

DefaultActionsobject []

默认规则动作列表。

ForwardGroupConfigobject

转发规则动作对应的配置。动作类型为 ForwardGroup 时有效。

ServerGroupTuplesobject []

转发目标服务器组。

ServerGroupIdstring

转发到的目的服务器组 ID。

sgp-i5qt20******
Typestring

动作类型。取值:ForwardGroup,表示转发至多个服务器组。

ForwardGroup
GzipEnabledboolean

是否开启 Gzip 压缩,对特定文件类型进行压缩。取值:

  • true:是。
  • false:否。
false
Http2Enabledboolean

是否开启 HTTP/2 特性。取值:

  • true:是。
  • false:否。
说明 仅 HTTPS 监听支持此参数。
false
IdleTimeoutinteger

指定连接空闲超时时间。单位:秒。取值范围:1~60

如果在超时时间内一直没有访问请求,负载均衡会暂时中断当前连接,直到接收到下一次请求时重新建立新的连接。

3
ListenerDescriptionstring

自定义监听名称。

HTTP_80
ListenerIdstring

监听 ID。

lsn-o4u54y73wq7b******
ListenerPortinteger

应用型负载均衡实例前端使用的端口。取值:1~65535

80
ListenerProtocolstring

监听协议。取值:

  • HTTP:协议类型为 HTTP。
  • HTTPS:协议类型为 HTTPS。
  • QUIC:协议类型为 QUIC。
HTTP
ListenerStatusstring

当前监听的状态,取值:

  • Provisioning:创建中。

  • Running:运行中。

  • Configuring:配置中。

  • Stopped:已停止。

Running
LoadBalancerIdstring

应用型负载均衡实例 ID。

alb-bd6oylbckp6k9x****
LogConfigobject

日志配置。

AccessLogRecordCustomizedHeadersEnabledboolean

访问日志是否开启携带自定义头。取值:

  • true:是。
  • false:否。
true
AccessLogTracingConfigobject

访问日志 Xtrace 相关的配置信息。

TracingEnabledboolean

是否开启 Xtrace 功能。取值:

  • true:是。
  • false:否。
说明 只有实例访问日志开关 AccessLogEnabled 打开时,才能设置此参数为 true
true
TracingSampleinteger

Xtrace 的采样率。取值:1~10000

说明 TracingEnabledtrue 时,此值有效。
100
TracingTypestring

Xtrace 类型,合法取值为 Zipkin

说明 TracingEnabledtrue 时,此值有效。
Zipkin
QuicConfigobject

启用关联 QUIC 监听时的配置信息。

QuicListenerIdstring

需要关联的 QUIC 监听 ID。QuicUpgradeEnabledtrue 时必选。HTTPS 监听时有效。

说明 原始监听和关联的 QUIC 监听必须属于同一个 ALB 实例,并且此 QUIC 监听之前没有被关联过。
lsn-o4u54y73wq7b******
QuicUpgradeEnabledboolean

是否开启 QUIC 升级。取值:

  • true:是。
  • false:否。
说明 仅 HTTPS 监听时有效。
true
RequestTimeoutinteger

指定请求超时时间。单位:秒。取值:1~180

如果在超时时间内后端服务器一直没有响应,负载均衡将放弃等待,给客户端返回HTTP 504错误码。

34
SecurityPolicyIdstring

安全策略。

说明 仅 HTTPS 监听支持此参数。
tls_cipher_policy_1_1
XForwardedForConfigobject

XForward头字段配置信息。

XForwardedForClientCertClientVerifyAliasstring

自定义头字段名称,只有当 XForwardedForClientCertClientVerifyEnabled 的值为 true 的时候,此值才会生效;否则该值不会生效。

取值限制:长度为 1~40 字符。支持字母 a-z、数字、短划线(-)和下划线(_)。

说明 仅 HTTPS 监听支持此参数。
test_client-verify-alias_123456
XForwardedForClientCertClientVerifyEnabledboolean

是否通过X-Forwarded-Clientcert-clientverify头字段获取对访问负载均衡实例客户端证书的校验结果。取值:

  • true:是。
  • false:否。
说明 仅 HTTPS 监听支持此参数。
true
XForwardedForClientCertFingerprintAliasstring

自定义头名称,只有当 XForwardedForClientCertFingerprintEnabled 的值为 true 时生效。

取值限制:长度为 1~40 字符。支持字母 a-z、数字、短划线(-)和下划线(_)。

说明 仅 HTTPS 监听支持此参数。
test_finger-print-alias_123456
XForwardedForClientCertFingerprintEnabledboolean

是否通过X-Forwarded-Clientcert-fingerprint头字段获取访问负载均衡实例客户端证书的指纹取值。取值:

  • true:是。
  • false:否。
说明 仅 HTTPS 监听支持此参数。
true
XForwardedForClientCertIssuerDNAliasstring

自定义头名称,只有当 XForwardedForClientCertIssuerDNEnabled 的值为 true 的时候,此值才会生效。

取值限制:长度为 1~40 字符。支持字母 a-z、数字、短划线(-)和下划线(_)。

说明 仅 HTTPS 监听支持此参数。
test_issue-dn-alias_123456
XForwardedForClientCertIssuerDNEnabledboolean

是否通过X-Forwarded-Clientcert-issuerdn头字段获取访问负载均衡实例客户端证书的发行者信息。取值:

  • true:是。
  • false:否。
说明 仅 HTTPS 监听支持此参数。
true
XForwardedForClientCertSubjectDNAliasstring

自定义头名称,只有当 XForwardedForClientCertSubjectDNEnabled 的值为 true 时,此值才会生效。

取值限制:长度为 1~40 字符。支持字母 a-z、数字、短划线(-)和下划线(_)。

说明 仅 HTTPS 监听支持此参数。
test_subject-dn-alias_123456
XForwardedForClientCertSubjectDNEnabledboolean

是否通过X-Forwarded-Clientcert-subjectdn头字段获取访问负载均衡实例客户端证书的所有者信息。取值:

  • true:是。
  • false:否。
说明 仅 HTTPS 监听支持此参数。
true
XForwardedForClientSrcPortEnabledboolean

是否通过X-Forwarded-Client-Port头字段获取访问负载均衡实例客户端的端口。取值:

  • true:是。
  • false:否。
说明 HTTP 和 HTTPS 监听支持此参数。
true
XForwardedForEnabledboolean

是否开启通过X-Forwarded-For头字段获取来访者真实 IP。取值:

  • true:是。
  • false:否。
说明 HTTP 和 HTTPS 监听支持此参数。
true
XForwardedForProtoEnabledboolean

是否通过X-Forwarded-Proto头字段获取负载均衡实例的监听协议。取值:

  • true:是。
  • false:否。
说明 HTTP、HTTPS 和 QUIC 监听支持此参数。
true
XForwardedForSLBIdEnabledboolean

是否通过SLB-ID头字段获取负载均衡实例 ID。取值:

  • true:是。
  • false:否。
说明 HTTP、HTTPS 和 QUIC 监听支持此参数。
true
XForwardedForSLBPortEnabledboolean

是否通过X-Forwarded-Port头字段获取负载均衡实例的监听端口。取值:

  • true:是。
  • false:否。
说明 HTTP、HTTPS 和 QUIC 监听支持此参数。
true
XForwardedForClientSourceIpsEnabledboolean

是否允许 ALB 从 X-Forwarded-For 头字段中查找真实客户端 IP。取值:

  • true:是。

  • false:否。

说明 HTTP、HTTPS 监听支持此参数。
false
XForwardedForClientSourceIpsTrustedstring

指定可信的代理 IP。

应用型负载均衡 ALB 会从后往前遍历X-Forwarded-For,选取第一个不在可信 IP 列表中的 IP 作为真实的客户端 IP,该 IP 会被用于源 IP 限速。

10.1.1.0/24
Tagsobject []

标签。

Keystring

标签键。最多支持 128 个字符,不能以 aliyun 或 acs:开头,不能包含 http://或 https://。

env
Valuestring

标签值。最多支持 128 个字符,不能以 aliyun 或 acs:开头,不能包含 http://或 https://。

product
MaxResultsinteger

本次请求所返回的最大记录条数。

50
NextTokenstring

当前调用返回读取到的位置,设置为空代表数据已经读取完毕。

FFmyTO70tTpLG6I3FmYAXGKPd****
RequestIdstring

请求 ID。

365F4154-92F6-4AE4-92F8-7FF3******
TotalCountinteger

本次请求条件下的数据总量。

1000

示例

正常返回示例

JSON格式

{
  "Listeners": [
    {
      "DefaultActions": [
        {
          "ForwardGroupConfig": {
            "ServerGroupTuples": [
              {
                "ServerGroupId": "sgp-i5qt20******"
              }
            ]
          },
          "Type": "ForwardGroup"
        }
      ],
      "GzipEnabled": false,
      "Http2Enabled": false,
      "IdleTimeout": 3,
      "ListenerDescription": "HTTP_80",
      "ListenerId": "lsn-o4u54y73wq7b******",
      "ListenerPort": 80,
      "ListenerProtocol": "HTTP",
      "ListenerStatus": "Running",
      "LoadBalancerId": "alb-bd6oylbckp6k9x****",
      "LogConfig": {
        "AccessLogRecordCustomizedHeadersEnabled": true,
        "AccessLogTracingConfig": {
          "TracingEnabled": true,
          "TracingSample": 100,
          "TracingType": "Zipkin"
        }
      },
      "QuicConfig": {
        "QuicListenerId": "lsn-o4u54y73wq7b******",
        "QuicUpgradeEnabled": true
      },
      "RequestTimeout": 34,
      "SecurityPolicyId": "tls_cipher_policy_1_1",
      "XForwardedForConfig": {
        "XForwardedForClientCertClientVerifyAlias": "test_client-verify-alias_123456",
        "XForwardedForClientCertClientVerifyEnabled": true,
        "XForwardedForClientCertFingerprintAlias": "test_finger-print-alias_123456",
        "XForwardedForClientCertFingerprintEnabled": true,
        "XForwardedForClientCertIssuerDNAlias": "test_issue-dn-alias_123456",
        "XForwardedForClientCertIssuerDNEnabled": true,
        "XForwardedForClientCertSubjectDNAlias": "test_subject-dn-alias_123456",
        "XForwardedForClientCertSubjectDNEnabled": true,
        "XForwardedForClientSrcPortEnabled": true,
        "XForwardedForEnabled": true,
        "XForwardedForProtoEnabled": true,
        "XForwardedForSLBIdEnabled": true,
        "XForwardedForSLBPortEnabled": true,
        "XForwardedForClientSourceIpsEnabled": false,
        "XForwardedForClientSourceIpsTrusted": "10.1.1.0/24"
      },
      "Tags": [
        {
          "Key": "env",
          "Value": "product"
        }
      ]
    }
  ],
  "MaxResults": 50,
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF3******",
  "TotalCount": 1000
}

错误码

HTTP status code错误码错误信息描述
403Forbidden.LoadBalancerAuthentication is failed for %s.负载均衡操作鉴权失败。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-01-29OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    新增错误码:403
  • 本页导读 (1)
文档反馈