创建监听器

功能介绍

给负载均衡器下创建监听器，用于监听后端云服务器的状态。

URI

POST /v1.0/{project_id}/elbaas/listeners

请求消息

• 请求参数

  无

• 请求样例

  {
      "name": "listener1",
      "description": "",
      "loadbalancer_id": "0b07acf06d243925bc24a0ac7445267a",
      "protocol": "HTTP",
      "port": 88,
      "backend_protocol": "HTTP",
      "backend_port": 80,
      "lb_algorithm": "roundrobin",
      "session_sticky": true,
      "sticky_session_type": "insert",
      "cookie_timeout": 100,
      "tcp_draining": true,
      "tcp_draining_timeout": 5
  }

响应消息

• 响应参数

  表2 响应参数

  参数	参数类型	描述
  update_time	String	更新时间。
  backend_port	Integer	后端端口。
  id	String	监听器ID。
  backend_protocol	String	后端协议。
  sticky_session_type	String	cookie的处理方式，设置为insert表示由ELB插入。session_sticky为true时有效，且默认insert方式。仅protocol为HTTP时有效。
  description	String	描述。
  loadbalancer_id	String	所属负载均衡器ID。
  create_time	String	创建时间。
  status	String	监听器状态。状态值：ACTIVE，PENDING_CREATE，ERROR。
  protocol	String	监听协议，用于区分四层和七层。
  port	Integer	监听端口。
  cookie_timeout	Integer	功能描述：cookie超时时间。session_sticky为true时且sticky_session_type为insert有效。 取值范围： 1-1440（单位为分）。
  admin_state_up	Boolean	弹性负载均衡器的管理状态， 取值范围： false：停用。 true：正常。
  session_sticky	Boolean	是否开启会话保持。true为开启会话保持，false为关闭会话保持。
  lb_algorithm	String	监听器负载均衡方式。
  name	String	监听器的名称。
  tcp_draining	Boolean	四层负载均衡器的后端云服务器删除后，该云服务器的TCP连接是否保持，不中断。protocol为“TCP”时tcp_draining有效。 取值范围：true、false。
  tcp_draining_timeout	Integer	四层负载均衡器的后端云服务器删除后，该云服务器的TCP连接保持的超时时间。 当protocol为“TCP”，且tcp_draining为“true”时该字段有效。 取值范围：0-60（单位为分钟）。
  ssl_protocols	String	监听器支持的SSL协议标准，用于启动特定的加密协议。 该字段仅protocol为HTTPS时返回。
  ssl_ciphers	String	加密协议的加密套件。 该字段仅protocol为HTTPS时返回。
  certificate_id	String	缺省的证书ID。 该字段仅protocol为HTTPS时返回。

状态码

• 正常

  200

• 异常

  状态码	编码	错误码说明
  400	badRequest	请求错误
  401	unauthorized	鉴权失败
  403	userDisabled	没有权限
  404	Not Found	请求的页面不存在
  500	authFault	内部错误
  503	serviceUnavailable	服务不可用