创建监听器

功能介绍

创建与负载均衡器绑定的监听器。

接口约束

• 只有具有ELB管理员权限的用户才能指定connection_limit的值。
• protocol参数只支持TCP、UDP、HTTP和TERMINATED_HTTPS。

URI

POST /v2/{project_id}/elb/listeners

请求消息

响应消息

请求示例

• 请求样例1 创建TCP监听器

  POST https://{Endpoint}/v2/145483a5107745e9b3d80f956713e6a3/elb/listeners
  
  {
      "listener": {
          "protocol_port": 80,
          "protocol": "TCP",
          "loadbalancer_id": "0416b6f1-877f-4a51-987e-978b3f084253",
          "name": "listener-test",
         
          "admin_state_up": true
      }
  }

• 请求样例2 创建TERMINATED_HTTPS类型的监听器

  POST https://{Endpoint}/v2/601240b9c5c94059b63d484c92cfe308/elb/listeners
  
  { 
      "listener": { 
          "protocol_port": 25, 
          "protocol": "TERMINATED_HTTPS", 
          "default_tls_container_ref": "02dcd56799e045bf8b131533cc911dd6",
          "loadbalancer_id": "0416b6f1-877f-4a51-987e-978b3f084253", 
          "name": "listener-test",
          "admin_state_up": true
      } 
  }

响应示例

• 响应样例1

  {
      "listener": {
          "protocol_port": 80,
          "protocol": "TCP",
          "description": "",
          "client_ca_tls_container_ref": null,
          "default_tls_container_ref": null,
          "admin_state_up": true,
          "http2_enable": false,
          "loadbalancers": [
              {
                  "id": "0416b6f1-877f-4a51-987e-978b3f084253"
              }
          ],
          "tenant_id": "145483a5107745e9b3d80f956713e6a3",
   
          "sni_container_refs": [],
          "connection_limit": -1,
          "default_pool_id": null,
          "tags": [],
          "id": "b7f32b52-6f17-4b16-9ec8-063d71b653ce",
          "name": "listener-test",
          "created_at": "2018-07-25T01:54:13", 
          "updated_at": "2018-07-25T01:54:14"
       }
  }

• 响应样例2

  {
      "listener": {
          "insert_headers": {},
          "protocol_port": 25,
          "protocol": "TERMINATED_HTTPS",
          "description": "",
          "default_tls_container_ref": "02dcd56799e045bf8b131533cc911dd6",
          "sni_container_refs": [],
          "loadbalancers": [
              {
                  "id": "0416b6f1-877f-4a51-987e-978b3f084253"
              }
          ],
          "tenant_id": "601240b9c5c94059b63d484c92cfe308",
     
          "created_at": "2019-01-21T12:38:31",
          "client_ca_tls_container_ref": null,
          "connection_limit": -1,
          "updated_at": "2019-01-21T12:38:31",
          "http2_enable": false,
          "admin_state_up": true,
          "default_pool_id": null,
          "id": "b56634cd-5ba8-460e-b5a2-6de5ba8eaf60",
          "tags": [],
          "name": "listener-test"
      }
  }

• 响应样例3

  {
      "listener": {
          "insert_headers": {},
          "protocol_port": 27,
          "protocol": "TERMINATED_HTTPS",
          "description": "",
          "default_tls_container_ref": "02dcd56799e045bf8b131533cc911dd6",
          "sni_container_refs": [
              "5882325fd6dd4b95a88d33238d293a0f",
              "e15d1b5000474adca383c3cd9ddc06d4"
          ],
          "loadbalancers": [
              {
                  "id": "6bb85e33-4953-457a-85a9-336d76125b7b"
              }
          ],
          "tenant_id": "601240b9c5c94059b63d484c92cfe308",
   
          "created_at": "2019-01-21T12:43:55", 
          "client_ca_tls_container_ref": null,
          "connection_limit": -1,
          "updated_at": "2019-01-21T12:43:55",
          "http2_enable": false,
          "admin_state_up": true,
          "default_pool_id": null,
          "id": "b2cfda5b-52fe-4320-8845-34e8d4dac2c7",
          "tags": [],
          "name": "listener-test"
      }
  }

返回码

请参见状态码。