Update pool member#

プールメンバーを更新します。

📒注: 本APIは非推奨です。「Update a Member」をご利用ください。

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://networking.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://networking.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

PUT

/v2.0/lbaas/pools/{pool_id}/members/{member-id}

HTTPステータスコード#

正常時:200

エラー時:401, 404, 422

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定
Description
admin_state_up body boolean 任意 リソースの管理状態「true」または「false」を指定
member body object 必須 メンバーオブジェクト
member_id path string 必須 メンバーID
pool_id path string 必須 プールID
weight body integer 任意 メンバーのウェイトは他のプールのメンバーと比べて、そのメンバーのリクエストまたはコネクションを提供する割合を特定します。
例えば、ウェイトが10であるメンバーはウェイトが2であるメンバーの5倍のリクエストを受け取ります。
ウェイト=0の場合は、そのメンバーは新しいコネクションを受け入れずに既存のコネクションだけにサービスを提供します。
0~256の値が設定され、デフォルトは1です。
name body string 任意 リソース名

レスポンスボディ(正常系)の説明#

名前 Type Description
address string メンバーのIPアドレス
admin_state_up boolean リソースの管理状態
「up(true)」または「down(false)」が表示されます。
id string メンバーID
name string リソース名
protocol_port integer リスニングするTCPまたはUDPポート番号
subnet_id string メンバーが属するプールのサブネットID
tenant_id string プロジェクトID
weight integer メンバーのウェイトは他のプールのメンバーと比べて、そのメンバーのリクエストまたはコネクションを提供する割合を特定します。
例えば、ウェイトが10であるメンバーはウェイトが2であるメンバーの5倍のリクエストを受け取ります。
ウェイト=0の場合は、そのメンバーは新しいコネクションを受け入れずに既存のコネクションだけにサービスを提供します。
0~256の値が設定され、デフォルトは1です。

リクエスト例#

{
    "member": {
        "weight": 5
    }
}

レスポンス例#

{
    "member": {
        "admin_state_up": true,
        "weight": 5,
        "tenant_id": "eabfefa3fd1740a88a47ad98e132d238",
        "protocol_port": 90,
        "id": "cf024846-7516-4e3a-b0fb-6590322c836f",
        "name": "",
        "subnet_id": "5a9a3e9e-d1aa-448e-af37-a70171f2a332"
    }
}
📒注: 本APIによる更新処理は非同期で動作するため、レスポンスボディには更新前の値が返ります。更新後の値を確認するためには、プールメンバーの詳細情報を表示するAPI(Show pool member details)を利用します。値の更新に時間を要する可能性もありますので、その場合は詳細情報を値が更新されるまで繰り返し取得してください。