ConoHa API Documantation

VIP作成 - Network API v2.0

Description

  • 1poolに1VIPのみ割り当てることが可能です
  • サブネットとVIPアドレスの指定は必須です
  • LB用のサブネット毎に10個まで作成可能です

Request URL

Network API v2.0

POST /v2.0/lb/vips

Request Paramters

Parameter Value Style Description
X-Auth-Token Userトークン header トークンID
protocol “TCP” plain VIPのプロトコルを指定
protocol_port ポート番号 plain A valid value is from 0 to 65535.
subnet_id subnet id plain LB用のサブネットを指定します。 事前に作成しておく必要があります。
admin_state_up bool plain 管理状態の有無
pool_id pool id plain VIPをつけるPOOLを指定します。既にVIPがついているPOOLは指定できません。(POOLに対してVIPは1対1の関係)
name (Optional) VIP名 plain ユニークである必要はありません。
address(Optional) IP address plain VIPのIPアドレスを指定します(指定したサブネット内のIP)。 指定したサブネットで既に1つ以上VIPを作成している場合は必ず入力します。但し、初めて作成する場合は自動で割り当てられるので必要ありません。
description (Optional) description plain description
connection_limit (Optional) limit plain 最大同時接続数を指定する。Default:-1(無制限)

Request Json

{
    "vip": {
        "protocol": "TCP",
        "name": "VIP_157-7-94-1-69",
        "admin_state_up": true,
        "subnet_id": "9c27f83a-ba6d-4e0e-b004-e34422e207a6",
        "pool_id": "c6be7cbb-7179-4ae2-8645-1b7e54ae6a27",
        "address": "157.7.94.1",
        "protocol_port": "69"
    }
}

Normal response codes

201

Example
※エンドポイントURLにつきましては、お客様環境によって異なりますので、コントロールパネルにてご確認の上ご利用ください。

  • REQ
curl -i -X POST \
-H "Accept: application/json" \
-H "X-Auth-Token: 0925897a3d4543218ff0dcd2bb378a8e" \
-d '{"vip": {"protocol": "TCP", "name": "VIP_157-7-94-1-69", "admin_state_up": true, "subnet_id": "9c27f83a-ba6d-4e0e-b004-e34422e207a6", "pool_id": "c6be7cbb-7179-4ae2-8645-1b7e54ae6a27", "address": "157.7.94.1", "protocol_port": "69"}}' \
https://networking.tyo1.conoha.io/v2.0/lb/vips
  • RES
HTTP/1.1 201 Created
Server: openresty/1.7.10.1
Date: Fri, 08 May 2015 12:47:51 GMT
Content-Type: application/json
Content-Length: 472
Connection: keep-alive


HTTP/1.1 201 Created
Date: Fri, 19 Dec 2014 07:44:16 GMT
Server: Apache
Content-Length: 506
Content-Type: application/json

{
    "vip": {
        "status": "PENDING_CREATE",
        "protocol": "TCP",
        "description": "",
        "address": "157.7.94.1 ",
        "protocol_port": 69,
        "port_id": "96dd6521-df79-4285-b77e-6d7eac01f48c",
        "id": "c3dd8156-9760-4366-9a06-16e7576ffdc4",
        "status_description": null,
        "name": "VIP_157-7-94-1-69 ",
        "admin_state_up": true,
        "subnet_id": "9c27f83a-ba6d-4e0e-b004-e34422e207a6",
        "tenant_id": "22394afc818d471ca2f0308c06ae7460",
        "connection_limit": -1,
        "pool_id": "c6be7cbb-7179-4ae2-8645-1b7e54ae6a27",
        "session_persistence": null
    }
}