Create Member#
プールメンバーを追加します。
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/pools/{pool_id}/members
HTTPステータスコード#
正常時:201
エラー時:400,401,403,404,409,500,503
リクエストパラメータの説明#
名前 | In | Type | デフォルト値 /必須指定 |
Description |
---|---|---|---|---|
address | body | string | 必須 | メンバーのIPアドレス |
admin_state_up | body | boolean | 任意 | リソースの管理状態 「true」または「false」を指定します。 |
member | body | object | 必須 | メンバーオブジェクト |
monitor_address | body | string | 任意 | ヘルスモニター用のIPアドレス |
monitor_port | body | integer | 任意 | ヘルスモニター用のポート番号 |
name | body | string | 任意 | リソース名 |
pool_id | path | uuid | 必須 | プールID |
project_id | body | string | 任意 | プロジェクトID |
protocol_port | body | integer | 必須 | リスニングするTCPポート番号 |
subnet_id | body | uuid | 任意 | メンバーが属するサブネットID |
weight | body | integer | 1 任意 |
メンバーのウェイト 他のプールのメンバーと比べて、そのメンバーのリクエストまたはコネクションを提供する割合を特定します。 例えば、ウェイトが10であるメンバーはウェイトが2であるメンバーの5倍のリクエストを受け取ります。 ウェイトが0の場合は、そのメンバーは新しいコネクションを受け入れずに既存のコネクションだけにサービスを提供します。 0~256の値が指定可能です。 デフォルトは1です。 |
レスポンスボディ(正常系)の説明#
名前 | Type | Description |
---|---|---|
address | string | メンバーのIPアドレス |
admin_state_up | boolean | リソースの管理状態 「true」または「false」が表示されます。 |
created_at | string | リソースが作成された日時(UTC)のタイムスタンプ |
id | uuid | メンバーID |
member | object | メンバーオブジェクト |
monitor_address | string | ヘルスモニター用のIPアドレス |
monitor_port | integer | ヘルスモニター用のポート番号 |
name | string | リソース名 |
operating_status | string | リソースの運用状況 「ONLINE」、「OFFLINE」、「NO_MONITOR」、「DRAINING」または「ERROR」が表示されます。 operating_statusの詳細は「Operating Status Codes」を参照してください。 |
project_id | string | プロジェクトID |
protocol_port | integer | リスニングするTCPポート番号 |
provisioning_status | string | リソースの提供状況 「ACTIVE」、「PENDING_CREATE」または「ERROR」が表示されます。 provisioning_statusの詳細は「Provisioning Status Codes」を参照してください。 |
subnet_id | uuid | メンバーが属するサブネットID |
updated_at | string | リソースの更新日時(UTC)のタイムスタンプ |
weight | integer | メンバーのウェイト 他のプールのメンバーと比べて、そのメンバーのリクエストまたはコネクションを提供する割合が表示されます。 例えば、ウェイトが10であるメンバーはウェイトが2であるメンバーの5倍のリクエストを受け取ります。 ウェイトが0の場合は、そのメンバーは新しいコネクションを受け入れずに既存のコネクションだけにサービスを提供します。 0~256の値が表示されます。 デフォルトは1です。 |
リクエスト例#
{ "member":{ "address":"192.168.0.7", "protocol_port":"80" } }
レスポンス例#
{ "member": { "address": "192.168.0.7", "admin_state_up": true, "created_at": "2019-03-22T08:56:44", "id": "f2aed3d5-5cc3-4088-8ffc-da7a263e2548", "monitor_address": null, "monitor_port": null, "name": "", "operating_status": "NO_MONITOR", "project_id": "51ed616c4bf0440ab6cfe5ff96edce91", "protocol_port": 80, "provisioning_status": "PENDING_CREATE", "subnet_id": null, "updated_at": null, "weight": 1 } }