更新时间:2023-12-18 GMT+08:00

更新后端云服务器

功能介绍

更新后端云服务器,可修改字段为后端云服务器的名称和权重,可以为性能好的服务器设置更大的权重,用来接收更多的流量。

接口约束

如果member绑定的负载均衡器的provisioning status不是ACTIVE,则不能更新该member。

URI

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

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

操作用户的项目ID。

pool_id

String

后端云服务器组id。

member_id

String

后端云服务器id。

说明:
  • 此处并非服务器的ID,而是ELB添加后端服服务器之后自动生成的member ID。
  • memberID可以通过查询后端云服务器列表接口获取。

请求消息

表2 请求参数

参数

是否必选

参数类型

描述

member

Member object

后端云服务器对象。详见表3

表3 member字段说明

参数

是否必选

参数类型

描述

name

String

后端云服务器的名称。

支持的最大字符长度:255

admin_state_up

Boolean

后端云服务器的管理状态。

该字段为预留字段,暂未启用。默认为true。

weight

Integer

后端云服务器的权重,取值范围[0,100]。

权重为0的后端不再接受新的请求。默认为1。

响应消息

表4 响应参数

参数

参数类型

描述

member

Member object

member对象。详见表5

表5 member字段说明

参数

参数类型

描述

id

String

后端云服务器的 ID。

说明:

此处并非服务器的ID,而是ELB添加后端服务器之后自动生成的member ID。

tenant_id

String

后端云服务器所在的项目ID。

支持的最大字符长度:255

project_id

String

此参数和tenant_id参数含义一样,均指后端云服务器所在的项目ID。

name

String

后端云服务器的名称。

支持的最大字符长度:255

address

String

后端云服务器对应的IP地址,该IP必须在subnet_id字段指定子网的网段中,例如192.168.3.11。

只能对应主网卡的IP。

支持的最大字符长度:64

protocol_port

Integer

后端端口的协议号,取值范围[1,65535]。

subnet_id

String

后端云服务器所在的子网ID。后端云服务器的IP地址在该子网的网段中。

不支持开启了ipv6的子网。

admin_state_up

Boolean

后端云服务器的管理状态。

该字段为预留字段,暂未启用。取值范围:true/false。

  • true表示开启。
  • false表示关闭。

weight

Integer

后端云服务器的权重,取值范围[0,100]。

权重为0的后端不再接受新的请求。默认为1。

operating_status

String

后端云服务器的健康状态,取值:

  • ONLINE,后端服务器正常运行。
  • NO_MONITOR,后端服务器无健康检查。
  • OFFLINE,已下线。

请求示例

  • 请求样例 更新后端云服务器的名称和权重
    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
        } 
    }

响应示例

  • 响应样例
    {
        "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"
        }
    }

返回码

请参见状态码