调用ListListeners接口查询全球实例下的监听列表。

使用说明

本接口用于查询全球加速实例下的监听列表，包括各监听的路由类型、状态、创建的时间戳、端口信息等。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListListeners

系统规定参数。取值：ListListeners。

RegionId String 是 cn-hangzhou

全球加速实例所在的地域ID，仅取值cn-hangzhou。

PageNumber Integer 否 1

列表的页码，默认值为1。

PageSize Integer 否 10

分页查询时每页的条目数，最大值为50，默认值为10。

AcceleratorId String 是 ga-bp1odcab8tmno0hdq****

全球加速实例ID。

返回数据

名称 类型 示例值 描述
TotalCount Integer 1

列表条目数。
Listeners Array of Listeners

监听信息。
Certificates Array of Certificate

SSL证书信息。
Type String Server

证书类型。

目前，仅支持返回Server（服务端证书）。

Id String 44983xxxx-cn-hangzhou

SSL证书ID。
BackendPorts Array of BackendPort

后端服务器端口信息。
FromPort String 80

后端服务器的起始端口。
ToPort String 80

后端服务器的结束端口。
ListenerId String lsr-bp1bpn0kn908w4nbw****

监听ID。
Description String Listener

监听的描述信息。
State String active

监听的状态。

  • active：正常。
  • init：初始化。
  • updating：配置中。
  • deleting：删除中。
ClientAffinity String SOURCE_IP

客户端亲和性。

  • 返回为NONE时：不保持客户端亲和性，即不能确保来自同一客户端的连接请求始终定向到同一终端节点。
  • 返回为SOURCE_IP时，保持客户端亲和性。即客户端访问有状态的应用程序时，可以将来自同一客户端的所有请求都定向到同一终端节点，而不考虑源端口和协议。
Protocol String tcp

监听的网络传输协议类型。

  • tcp：TCP协议。
  • udp：UDP协议。
  • http：HTTP协议。
  • https：HTTPS协议。
CreateTime Long 1577786252000

创建监听的时间戳。单位：毫秒。
PortRanges Array of PortRanges

监听端口信息。
FromPort Integer 20

用来接收请求并向终端节点进行转发的起始监听端口。
ToPort Integer 20

用来接收请求并向终端节点进行转发的结束监听端口。
Name String Listener

监听的名称。
ProxyProtocol Boolean true

是否开启了保持客户端源IP功能。

  • true：开启了保持客户端源IP功能。开启后，支持后端服务查看客户端的原始IP地址。
  • false：未开启保持客户端源IP功能。
AcceleratorId String ga-bp1odcab8tmno0hdq****

全球加速实例ID。
XForwardedForConfig Object

XForward字段配置信息。

XForwardedForGaIdEnabled Boolean false

是否通过GA-ID头字段获取全球加速实例ID。

  • true：是。
  • false：否。
说明 仅HTTP和HTTPS监听支持此参数。
XRealIpEnabled Boolean false

是否通过X-Real-IP字段获取真实的客户端IP。

  • true：是。
  • false：否。
说明 仅HTTP和HTTPS监听支持此参数。
XForwardedForGaApEnabled Boolean false

是否通过GA-AP字段获取加速地域信息。

  • true：是。
  • false：否。
说明 仅HTTP和HTTPS监听支持此参数。
XForwardedForProtoEnabled Boolean false

是否通过GA-X-Forward-Proto字段获取全球加速实例的监听协议。

  • true：是。
  • false：否。
说明 仅HTTP和HTTPS监听支持此参数。
XForwardedForPortEnabled Boolean false

是否通过GA-X-Forward-Port字段获取全球加速实例的监听端口。

  • true：是。
  • false：否。
说明 仅HTTP和HTTPS监听支持此参数。
SecurityPolicyId String tls_cipher_policy_1_0

安全策略实例ID。

  • tls_cipher_policy_1_0
    • 支持的TLS版本：TLSv1.0、TLSv1.1和TLSv1.2。
    • 支持的加密算法套件：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和DES-CBC3-SHA。
  • tls_cipher_policy_1_1
    • 支持的TLS版本： TLSv1.1和TLSv1.2。
    • 支持的加密算法套件：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和DES-CBC3-SHA。
  • tls_cipher_policy_1_2
    • 支持的TLS版本：TLSv1.2。
    • 支持的加密算法套件：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和DES-CBC3-SHA。
  • tls_cipher_policy_1_2_strict
    • 支持的TLS版本：TLSv1.2。
    • 支持的加密算法套件：ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-RSA-AES128-SHA和ECDHE-RSA-AES256-SHA。
  • tls_cipher_policy_1_2_strict_with_1_3
    • 支持的TLS版本：TLSv1.2及TLSv1.3。
    • 支持的加密算法套件：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、ECDHE-RSA-AES256-SHA。
说明 仅HTTPS监听支持此参数。
Type String Standard

监听的路由类型。

  • Standard：智能路由类型。
  • CustomRouting：自定义路由类型。
PageSize Integer 10

分页查询时每页的条目数。
RequestId String 6FEA0CF3-D3B9-43E5-A304-D217037876A8

请求ID。
PageNumber Integer 1

列表的页码。

示例

请求示例

http(s)://[Endpoint]/?Action=ListListeners
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=10
&AcceleratorId=ga-bp1odcab8tmno0hdq****
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListListenersResponse>
    <TotalCount>1</TotalCount>
    <Listeners>
        <Certificates>
            <Type>Server</Type>
            <Id>44983xxxx-cn-hangzhou</Id>
        </Certificates>
        <BackendPorts>
            <FromPort>80</FromPort>
            <ToPort>80</ToPort>
        </BackendPorts>
        <ListenerId>lsr-bp1bpn0kn908w4nbw****</ListenerId>
        <Description>Listener</Description>
        <State>active</State>
        <ClientAffinity>SOURCE_IP</ClientAffinity>
        <Protocol>TCP</Protocol>
        <CreateTime>1577786252000</CreateTime>
        <PortRanges>
            <FromPort>20</FromPort>
            <ToPort>20</ToPort>
        </PortRanges>
        <Name>Listener</Name>
        <ProxyProtocol>true</ProxyProtocol>
        <AcceleratorId>ga-bp1odcab8tmno0hdq****</AcceleratorId>
        <XForwardedForConfig>
            <XForwardedForGaIdEnabled>false</XForwardedForGaIdEnabled>
            <XRealIpEnabled>false</XRealIpEnabled>
            <XForwardedForGaApEnabled>false</XForwardedForGaApEnabled>
            <XForwardedForProtoEnabled>false</XForwardedForProtoEnabled>
            <XForwardedForPortEnabled>false</XForwardedForPortEnabled>
        </XForwardedForConfig>
        <SecurityPolicyId>tls_cipher_policy_1_0</SecurityPolicyId>
    </Listeners>
    <PageSize>10</PageSize>
    <RequestId>6FEA0CF3-D3B9-43E5-A304-D217037876A8</RequestId>
    <PageNumber>1</PageNumber>
</ListListenersResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "Listeners" : [ {
    "Certificates" : [ {
      "Type" : "Server",
      "Id" : "44983xxxx-cn-hangzhou"
    } ],
    "BackendPorts" : [ {
      "FromPort" : "80",
      "ToPort" : "80"
    } ],
    "ListenerId" : "lsr-bp1bpn0kn908w4nbw****",
    "Description" : "Listener",
    "State" : "active",
    "ClientAffinity" : "SOURCE_IP",
    "Protocol" : "TCP",
    "CreateTime" : 1577786252000,
    "PortRanges" : [ {
      "FromPort" : 20,
      "ToPort" : 20
    } ],
    "Name" : "Listener",
    "ProxyProtocol" : true,
    "AcceleratorId" : "ga-bp1odcab8tmno0hdq****",
    "XForwardedForConfig" : {
      "XForwardedForGaIdEnabled" : false,
      "XRealIpEnabled" : false,
      "XForwardedForGaApEnabled" : false,
      "XForwardedForProtoEnabled" : false,
      "XForwardedForPortEnabled" : false
    },
    "SecurityPolicyId" : "tls_cipher_policy_1_0"
  } ],
  "PageSize" : 10,
  "RequestId" : "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
  "PageNumber" : 1
}

错误码

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