華為云計(jì)算 云知識 更新后端云服務(wù)器UpdateMember
更新后端云服務(wù)器UpdateMember

 

功能介紹

更新后端 云服務(wù)器 ,可修改字段為后端云服務(wù)器的名稱和權(quán)重,可以為性能好的服務(wù)器設(shè)置更大的權(quán)重,用來接收更多的流量。

接口約束

如果member綁定的 負(fù)載均衡 器的provisioning status不是ACTIVE,則不能更新該member。

調(diào)試

您可以在API Explorer中直接運(yùn)行調(diào)試該接口。

URI

PUT /v2/{project_id}/elb/pools/{pool_id}/members/{member_id}

表1 參數(shù)說明

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

操作用戶的項(xiàng)目ID。

獲取方法詳見獲取項(xiàng)目ID。

pool_id

String

后端云服務(wù)器組id。

member_id

String

后端云服務(wù)器id。

說明:
  • 此處并非服務(wù)器的ID,而是ELB添加后端服服務(wù)器之后自動生成的member ID。
  • memberID可以通過查詢后端云服務(wù)器列表接口獲取。

請求消息

表2 請求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

member

Member object

后端云服務(wù)器對象。詳見表3。

表3 member字段說明

參數(shù)

是否必選

參數(shù)類型

描述

name

String

后端云服務(wù)器的名稱。

支持的最大字符長度:255

admin_state_up

Boolean

后端云服務(wù)器的管理狀態(tài)。

該字段為預(yù)留字段,暫未啟用。默認(rèn)為true。

weight

Integer

后端云服務(wù)器的權(quán)重,取值范圍[0,100]。

權(quán)重為0的后端不再接受新的請求。默認(rèn)為1。

響應(yīng)消息

表4 響應(yīng)參數(shù)

參數(shù)

參數(shù)類型

描述

member

Member object

member對象。詳見表5。

表5 member字段說明

參數(shù)

參數(shù)類型

描述

id

String

后端云服務(wù)器的 ID。

說明:

此處并非服務(wù)器的ID,而是ELB添加后端服務(wù)器之后自動生成的member ID。

tenant_id

String

后端云服務(wù)器所在的項(xiàng)目ID。

支持的最大字符長度:255

project_id

String

此參數(shù)和tenant_id參數(shù)含義一樣,均指后端云服務(wù)器所在的項(xiàng)目ID。

name

String

后端云服務(wù)器的名稱。

支持的最大字符長度:255

address

String

后端云服務(wù)器對應(yīng)的IP地址,該IP必須在subnet_id字段指定子網(wǎng)的網(wǎng)段中,例如192.168.3.11。

只能對應(yīng)主網(wǎng)卡的IP。

支持的最大字符長度:64

protocol_port

Integer

后端端口的協(xié)議號,取值范圍[1,65535]。

subnet_id

String

后端云服務(wù)器所在的子網(wǎng)ID。后端云服務(wù)器的IP地址在該子網(wǎng)的網(wǎng)段中。

不支持開啟了ipv6的子網(wǎng)。

admin_state_up

Boolean

后端云服務(wù)器的管理狀態(tài)。

該字段為預(yù)留字段,暫未啟用。取值范圍:true/false。

  • true表示開啟。
  • false表示關(guān)閉。

weight

Integer

后端云服務(wù)器的權(quán)重,取值范圍[0,100]。

權(quán)重為0的后端不再接受新的請求。默認(rèn)為1。

operating_status

String

后端云服務(wù)器的健康狀態(tài),取值:

  • ONLINE,后端服務(wù)器正常運(yùn)行。
  • NO_MONITOR,后端服務(wù)器無健康檢查。
  • OFFLINE,已下線。

請求示例

  • 請求樣例 更新后端云服務(wù)器的名稱和權(quán)重
    PUT https://{Endpoint}/v2/145483a5107745e9b3d80f956713e6a3/elb/pools/
    5a9a3e9e-d1aa-448e-af37-a70171f2a332/members/c0042496-e220-44f6-914b-e6ca33bab503 { "member": { "name": "member create test", "weight": 10 } }

響應(yīng)示例

  • 響應(yīng)樣例
    {
        "member": {
            "name": "member-jy-tt-1", 
            "weight": 1, 
            "admin_state_up": true, 
            "subnet_id": "33d8b01a-bbe6-41f4-bc45-78a1d284d503", 
            "tenant_id": "145483a5107745e9b3d80f956713e6a3",
            "project_id": "145483a5107745e9b3d80f956713e6a3",
            "address": "192.168.44.11", 
            "protocol_port": 88, 
            "operating_status": "ONLINE", 
            "id": "c0042496-e220-44f6-914b-e6ca33bab503"
        }
    }

返回碼

請參見狀態(tài)碼。