创建监听器

CreateListeners(创建监听器)

Request Parameters（请求参数）

LoadBalancerId

• 负载均衡的ID
• 类型: String
• 是否可缺省: 否

ListenerState

• 监听器的状态
• 类型: String
• 可取值: start |stop
• 是否可缺省: 否

ListenerName

• 监听器的名称
• 类型: String
• 是否可缺省: 是
• 缺省值: ksc_listener

ListenerProtocol

• 监听器协议
• 类型: String
• 有效值:
  • TCP
  • UDP（香港地区暂不支持 UDP 协议）
  • HTTP
  • HTTPS
• 是否可缺省: 否

CertificateId

• 证书的ID，HTTPS类型监听器创建此参数不可缺省
• 类型: String
• 是否可缺省: 是

ListenerPort

• 监听器的协议端口
• 类型: Integer
• 可取值: 1-65535
• 是否可缺省: 否

Method

• 监听器的转发方式
• 类型: String
• 有效值: RoundRobin | LeastConnections | MasterSlave | QUIC_CID
• 是否可缺省: 否

SessionState

• 会话保持的状态
• 类型: String
• 可取值: start |stop
• 是否可缺省: 否

SessionPersistencePeriod

• 会话保持超时时间
• 类型: Long
• 可取值: 1-86400，单位秒
• 是否可缺省: 是
• 缺省值: 3600

CookieType

• 会话类型，tcp类型监听器没有此参数，http类型监听器才有。
• 类型: String
• 可取值: ImplantCookie |RewriteCookie
• 是否可缺省: 是

CookieName

• Cookie的名称，tcp类型监听器没有此参数，http类型监听器且CookieType为RewriteCookie才需要填写。
• 类型: String
• 是否可缺省: 是

返回目录

Response Elements（返回值）

RequestId

• 请求ID
• 类型: String

Listener

• 负载均衡信息
• 类型: Listener

Examples（举例）

Sample Request(请求)

https://slb.region.api.ksyun.com/?Action=CreateListeners
&Version=2016-03-04
&LoadBalancerId=845c026f-aedd-417c-873e-bc2eab9f7f55
&ListenerProtocol=TCP
&ListenerState=start
&ListenerPort=810
&Method=RoundRobin
&SessionState=start
&SessionPersistencePeriod=3600

Sample Response（返回）

<CreateListenersResponse xmlns="http://slb.ksyun.com/doc/2016-03-04/">
    <CreateTime>2016-11-29 14:44:16</CreateTime>
    <ListenerId>8017e46e-5ed5-4d69-8a95-264f4fc4cb0c</ListenerId>
    <Method>RoundRobin</Method>
    <ListenerName>ksc_listener</ListenerName>
    <LoadBalancerId>845c026f-aedd-417c-873e-bc2eab9f7f55</LoadBalancerId>
    <ListenerProtocol>TCP</ListenerProtocol>
    <ListenerPort>810</ListenerPort>
    <RequestId>aae7d1cb-671b-46da-9548-7110c75d72a6</RequestId>
    <Session>
        <SessionState>start</SessionState>
        <SessionPersistencePeriod>3600</SessionPersistencePeriod>
    </Session>
    <ListenerState>stop</ListenerState>
</CreateListenersResponse>