Request URL

Network API v2.0

POST /v2.0/lb/pools

Request Paramters

Parameter Value Style Description
X-Auth-Token User Token header
name Pool name plain
protocol protocol plain TCP
subnet_id subnet id plain Specify a subnet for LB. Please create it in advance.(
lb_method lb method plain ROUND_ROBIN or LEAST_CONNECTIONS

Request Json

    "pool": {
        "lb_method": "ROUND_ROBIN",
        "protocol": "TCP",
        "name": "Example pool",
        "subnet_id": "1981f108-3c48-48d2-b908-30f7d28532c9"

Normal response codes


Error response codes

The error below will be displayed when you choose the subnet ID that you cannot be specified for Pool.

404 {"NeutronError": {"message": "No eligible backend for pool aae2e4db-71a1-4b8a-900b-4abbe94d3aa6", "type": "NoEligibleBackend", "detail": ""}}

The error below will be displayed when it arrives at a limit on the number.

400 {"badRequest":{"message":"Maximum number of pool for vip subnet allowed (10) exceeded","code":400}}


curl -i -X POST \
-H "Accept: application/json" \
-H "X-Auth-Token: 0925897a3d4543218ff0dcd2bb378a8e" \
-d '{"pool": {"lb_method": "ROUND_ROBIN", "protocol": "TCP", "name": "pool-test-150223-01", "subnet_id": "9c27f83a-ba6d-4e0e-b004-e34422e207a6"}}' \
HTTP/1.1 201 Created
Server: openresty/
Date: Fri, 08 May 2015 09:13:29 GMT
Content-Type: application/json
Content-Length: 412
Connection: keep-alive

    "pool": {
        "status": "PENDING_CREATE",
        "lb_method": "ROUND_ROBIN",
        "protocol": "TCP",
        "description": "",
        "health_monitors": [],
        "members": [],
        "status_description": null,
        "id": "b9e3bc41-d76c-4c93-9337-39f056b6a9ef",
        "vip_id": null,
        "name": "pool-test-150223-01",
        "admin_state_up": true,
        "subnet_id": "9c27f83a-ba6d-4e0e-b004-e34422e207a6",
        "tenant_id": "22394afc818d471ca2f0308c06ae7460",
        "health_monitors_status": [],
        "provider": "lvs_dsr"