创建后端云服务器组

功能介绍

创建后端云服务器组。将多个后端云服务器添加到后端云服务器组中后，请求会在后端云服务器间按后端云服务器组的负载均衡算法和后端云服务器的权重来做请求分发。

接口约束

• 指定session-persistence参数时，只有当type是APP_COOKIE时，才可以设置cookie_name。

URI

POST /v2/{project_id}/elb/pools

请求消息

响应消息

请求示例

• 请求样例1
  • step1 请求样例 根据弹性云服务器id查询对应的subnet_id和address，其中device_id为弹性云服务器的id。取响应体中主网卡（primary_interface为true的port）的subnet_id、ip_address。

    GET https://{VPCEndpoint}/v2.0/ports?device_id=f738c464-b5c2-45df-86c0-7f436620cd54

    step1 响应样例

    {
        "ports": [
            {
                "id": "94971c39-46f0-443a-85e8-31cb7497c78e",
                "name": "",
                "status": "ACTIVE",
                "admin_state_up": true,
                "fixed_ips": [
                    {
                        "subnet_id": "33d8b01a-bbe6-41f4-bc45-78a1d284d503",
                        "ip_address": "192.168.44.11"
                    }
                ],
                "mac_address": "fa:16:3e:5c:d2:57",
                "network_id": "1b76b9c2-9b7e-4ced-81bd-d13f7389d7c9",
                "tenant_id": "04dd36f978800fe22f9bc00bea090736",
                "project_id": "04dd36f978800fe22f9bc00bea090736",
                "device_id": "f738c464-b5c2-45df-86c0-7f436620cd54",
                "device_owner": "compute:xx-xxxx-4a",
                "security_groups": [
                    "a10dfc31-0055-4b84-b36e-1291b918125c",
                    "7a233393-5be2-4dff-8360-1558dd950f6e"
                ],
                "extra_dhcp_opts": [],
                "allowed_address_pairs": [],
                "binding:vnic_type": "normal",
                "binding:vif_details": {
                    "primary_interface": true
                },
                "binding:profile": {},
                "port_security_enabled": true,
                "created_at": "2019-11-12T17:17:51",
                "updated_at": "2019-11-12T17:17:51"
            }
        ]
    }

  • step2 创建后端云服务器组，不开启会话保持

    POST https://{Endpoint}/v2/601240b9c5c94059b63d484c92cfe308/elb/pools
    
    {
        "pool": {
            "lb_algorithm":"ROUND_ROBIN",
            "loadbalancer_id": "63ad9dfe-4750-479f-9630-ada43ccc8117",
            "protocol":"HTTP"
        }
    }

• 请求样例2 创建后端云服务器组，并开启APP_COOKIE类型的会话保持

  POST https://{Endpoint}/v2/145483a5107745e9b3d80f956713e6a3/elb/pools
  
  {
    "pool": {
      "lb_algorithm": "ROUND_ROBIN",
      "loadbalancer_id": "370fb112-e920-486a-b051-1d0d30704dd3",
      "protocol": "HTTP",
      "session_persistence": {
        "cookie_name": "my_cookie",
        "type": "APP_COOKIE",
        "persistence_timeout": 1
      },
      "admin_state_up": true
    }
  }

• 请求样例3 创建HTTP后端云服务器组，并开启HTTP_COOKIE类型的会话保持

  POST https://{Endpoint}/v2/601240b9c5c94059b63d484c92cfe308/elb/pools 
  
  {
      "pool": {
          "lb_algorithm":"ROUND_ROBIN",
          "loadbalancer_id": "63ad9dfe-4750-479f-9630-ada43ccc8117",
          "protocol":"HTTP",
          "session_persistence":{
          	"type":"HTTP_COOKIE"
          }
      }
  }

响应示例

• 响应样例1

  {
      "pool": {
          "lb_algorithm": "ROUND_ROBIN",
          "protocol": "HTTP",
          "description": "",
          "admin_state_up": true,
          "loadbalancers": [
              {
                  "id": "63ad9dfe-4750-479f-9630-ada43ccc8117"
              }
          ],
          "tenant_id": "601240b9c5c94059b63d484c92cfe308",
          "session_persistence": null,
          "healthmonitor_id": null,
          "listeners": [],
          "members": [],
          "id": "4e496951-befb-47bf-9573-c1cd11825c07",
          "name": ""
      }
  }

• 响应样例2

  {
    "pool": {
      "lb_algorithm": "ROUND_ROBIN",
      "protocol": "HTTP",
      "description": "",
      "admin_state_up": true,
      "loadbalancers": [
        {
          "id": "6b041b9e-976b-40ba-b075-375be6110b53"
        }
      ],
      "tenant_id": "145483a5107745e9b3d80f956713e6a3",
      "session_persistence": {
        "cookie_name": "my_cookie",
        "type": "APP_COOKIE",
        "persistence_timeout": 1
      },
      "healthmonitor_id": null,
      "listeners": [
        {
          "id": "370fb112-e920-486a-b051-1d0d30704dd3"
        }
      ],
      "members": [],
      "id": "307f8968-9474-4d0c-8434-66be09dabcc1",
      "name": ""
    }
  } 

• 响应样例3

  {
      "pool": {
          "lb_algorithm": "ROUND_ROBIN",
          "protocol": "HTTP",
          "description": "",
          "admin_state_up": true,
          "loadbalancers": [
              {
                  "id": "63ad9dfe-4750-479f-9630-ada43ccc8117"
              }
          ],
          "tenant_id": "601240b9c5c94059b63d484c92cfe308",
          "session_persistence": {
              "persistence_timeout": 1440,
              "cookie_name": null,
              "type": "HTTP_COOKIE"
          },
          "healthmonitor_id": null,
          "listeners": [],
          "members": [],
          "id": "d46eab56-d76b-4cd3-8952-3c3c4cf113aa",
          "name": ""
      }
  }

返回码

请参见状态码。