検討中のお客様はこちら

0120-50-6065

10:00〜19:00
土日祝、年末年始除く

お申し込み

VIP作成

Description

VIPの設定を作成します。
1つのPoolに対して1つのVIPの設定のみ割り当てることが可能です。
サブネットとVIPの指定は必須です。

Request URL

Network API v2.0

POST /v2.0/lb/vips

Request Json

{
    "vip": {
        "admin_state_up": 管理状態の有無,
        "name": "VIP設定の名前", 
        "pool_id": "プールID", 
        "protocol": "プロトコル", 
        "protocol_port": "ポート番号", 
        "subnet_id": "サブネットID"
    }
}

Request Parameters

Parameter Value Style Description
X-Auth-Token Userトークン header トークン発行 にて払い出されたID
protocol TCP
UDP
plain VIPのプロトコルを指定します。
※NAT LBのみUDPの指定が可能
protocol_port 0 ~ 65535 plain ポート番号を指定します。
subnet_id サブネットID plain サブネット一覧取得 にてご確認ください。
admin_state_up true
false
plain 管理状態の有無
pool_id プールID plain VIPをつけるPOOLを指定します。
既にVIPがついているPOOLは指定できません。POOL一覧取得 にてご確認ください。
name(Optional) VIP設定の名前 plain VIPの設定に任意の名前を指定します。
address(Optional) VIP plain VIP(LBに付与されたグローバルIPアドレス)を指定します。
また、初めてVIPを作成される場合の入力は任意となりますが、指定したサブネットで既に1つ以上のVIPを作成している場合、入力が必須となります。
description(Optional) VIP設定の
説明・概要
plain VIPの設定について任意の説明・概要を指定します。
session_persistence(Optional) SOURCE_IP plain セッション維持を有効にする場合、指定します。
※NAT LBのみ指定が可能
connection_limit(Optional) 最大同時接続数 plain 最大同時接続数を指定します。
※デフォルトは「-1 (無制限)」

Response

  • Normal response codes
201

Example

  • Request
curl -i -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークンID" \
-d '{"vip":{"admin_state_up":管理状態の有無,"name":"VIP設定の名前","address":"VIP","protocol":"プロトコル","protocol_port":"ポート番号","subnet_id":"サブネットID","pool_id":"プールID"}}' \
https://networking.gpu-sys.cloud/v2.0/lb/vips
  • Response
HTTP/1.1 201 Created
Date: Wed, 26 Aug 2020 11:52:41 GMT
Server: Apache
Content-Length: 510
Content-Type: application/json

{
  "vip": {
    "status": "ACTIVE",
    "protocol": "プロトコル",
    "description": "",
    "address": "VIP",
    "protocol_port": ポート番号,
    "port_id": "ポートID",
    "id": "VIP ID",
    "status_description": null,
    "name": "VIP設定の名前",
    "admin_state_up": 管理状態の有無,
    "subnet_id": "サブネットID",
    "tenant_id": "テナントID",
    "connection_limit": -1,
    "pool_id": "プールID",
    "session_persistence": null
  }
}