Create a Load Balancer#
ロードバランサーを作成します。
APIエンドポイント#
リージョン | APIエンドポイント |
---|---|
西日本リージョン3の場合 | https://loadbalancer.jp-west-3.cloud.global.fujitsu.com |
東日本リージョン3の場合 | https://loadbalancer.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
POST
/v2.0/lbaas/loadbalancers
HTTPステータスコード#
正常時:201
エラー時:400, 401, 403, 404, 500, 503
リクエストパラメータの説明#
名前 | In | Type | デフォルト値 /必須指定 |
Description |
---|---|---|---|---|
admin_state_up | body | boolean | true 任意 |
リソースの管理状態 「true」または「false」を指定します。 |
description | body | string | 任意 | リソースの説明 |
listeners | body | array | 任意 | リスナーオブジェクトの一覧 |
loadbalancer | body | object | 必須 | ロードバランサーオブジェクト |
name | body | string | 任意 | リソース名 |
pools | body | array | 任意 | プールオブジェクトの一覧 |
project_id | body | string | 任意 | プロジェクトID |
provider | body | string | octavia 任意 |
ロードバランサーの提供者の名前 |
vip_address | body | string | 任意 | 仮想IP (VIP)のIPアドレス |
vip_network_id | body | uuid | 任意 | 仮想IP (VIP)のネットワークID 📒注: vip_network_id、vip_port_idまたはvip_subnet_idを指定する必要があります。 |
vip_port_id | body | uuid | 任意 | 仮想IP (VIP)のポートID 📒注:- vip_network_id、vip_port_idまたはvip_subnet_idを指定する必要があります。 - リクエストパラメータ"vip_port_id"にお客様が事前に作成したvipを指定する場合、vip作成時には必ずリクエストパラメータ"device_owner"に"nuage:vip"を設定してください。この設定をしない場合、Floating IP経由での通信ができません。 |
vip_subnet_id | body | uuid | 任意 | 仮想IP (VIP)のサブネットID 📒注: vip_network_id、vip_port_idまたはvip_subnet_idを指定する必要があります。 |
レスポンスボディ(正常系)の説明#
名前 | Type | Description |
---|---|---|
admin_state_up | boolean | リソースの管理状態 「true」または「false」が表示されます。 |
created_at | string | リソースが作成された日時(UTC)のタイムスタンプ |
description | string | リソースの説明 |
flavor_id | uuid | フレーバーID |
id | uuid | ロードバランサーID |
listeners | array | 関連付けられているリスナーオブジェクトの一覧 |
loadbalancer | object | ロードバランサーオブジェクト |
name | string | リソース名 |
operating_status | string | リソースの運用状況 「ONLINE」、「OFFLINE」または「ERROR」が表示されます。 operating_statusの詳細は「Operating Status Codes」を参照してください。 |
pools | array | 関連付けられているプールオブジェクトの一覧 |
project_id | string | プロジェクトID |
provider | string | ロードバランサーの提供者の名前 |
provisioning_status | string | リソースの提供状況 「ACTIVE」、「PENDING_CREATE」または「ERROR」が表示されます。 provisioning_statusの詳細は「Provisioning Status Codes」を参照してください。 |
updated_at | string | リソースの更新日時(UTC)のタイムスタンプ |
vip_address | string | 仮想IP (VIP)のIPアドレス |
vip_network_id | uuid | 仮想IP (VIP)のネットワークID |
vip_port_id | uuid | 仮想IP (VIP)のポートID |
vip_qos_policy_id | uuid | 仮想IP (VIP)に適用されるQoSポリシーのID |
vip_subnet_id | uuid | 仮想IP (VIP)のサブネットID |
リクエスト例#
{ "loadbalancer": { "admin_state_up": true, "name":"loadbalancer1", "project_id": "51ed616c4bf0440ab6cfe5ff96edce91", "vip_subnet_id":"6dd92e5d-f5c5-4527-9308-2a3f9e5ebf36" } }
レスポンス例#
{ "loadbalancer": { "admin_state_up": true, "created_at": "2019-03-19T04:30:17", "description": "", "flavor_id": "", "id": "7a0cdb82-3920-4a38-964a-26cc7178a086", "listeners": [], "name": "loadbalancer1", "operating_status": "OFFLINE", "pools": [], "project_id": "51ed616c4bf0440ab6cfe5ff96edce91", "provider": "octavia", "provisioning_status": "PENDING_CREATE", "updated_at": null, "vip_address": "192.168.0.41", "vip_network_id": "61200693-0812-4cbf-9ce1-5d2e872bd9bc", "vip_port_id": "e9d0f78e-fec3-4d37-813b-626c1fe66e48", "vip_qos_policy_id": null, "vip_subnet_id": "6dd92e5d-f5c5-4527-9308-2a3f9e5ebf36" } }