リスナー作成

Description

リスナーを作成します。

リスナーにて接続を受け付けるポート番号やプロトコルを設定します。

リスナーを作成するには、ロードバランサーが追加されている必要があります。

Request URL

Load Balancer API

POST /v2.0/lbaas/listeners

Request Json

{
  "listener": {
    "protocol": "プロトコル",
    "protocol_port": ポート番号,
    "loadbalancer_id": "ロードバランサーID",
    "name": "リスナー名"
  }
}

Request Parameters

Parameter	Value	Style	Description
X-Auth-Token	トークン	header	トークンの情報を指定します。トークンの発行方法は、トークン発行にてご確認ください。
protocol	TCP UDP	body	プロトコルを指定します。
protocol_port	ポート番号	body	接続を受け付けるポート番号を指定します。
loadbalancerid	ロードバランサーID	body	リスナーを紐付けるロードバランサーIDを指定します。ロードバランサーIDの確認方法は、ロードバランサー一覧取得を実行の上、レスポンス結果から対象ロードバランサーのロードバランサーIDをご確認ください。
name	リスナー名	body	任意のリスナー名を指定します。

Response Code

Success

Example

Request

curl -X POST 
-H "Accept: application/json" 
-H "X-Auth-Token: トークン" 
-d '{"listener": {"protocol": "プロトコル","protocol_port": ポート番号,"loadbalancer_id": "ロードバランサーID","name": "リスナー名"}}' 
https://lbaas.c3j1.conoha.io/v2.0/lbaas/listeners

Response

{
	"listener": {
		"id": "リスナーID",
		"name": "リスナー名",
		"description": "",
		"provisioning_status": "PENDING_CREATE",
		"operating_status": "OFFLINE",
		"admin_state_up": true,
		"protocol": "TCP",
		"protocol_port": 10022,
		"connection_limit": -1,
		"project_id": "テナントID",
		"default_pool_id": null,
		"loadbalancers": [
			{
				"id": "ロードバランサーID"
			}
		],
		"tenant_id": "テナントID"
	}
}

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。