文档首页/ 弹性负载均衡 ELB/ API参考（吉隆坡区域）/ API/ 后端云服务器/ 更新后端云服务器
更新时间：2022-08-15 GMT+08:00
查看PDF
分享

更新后端云服务器

功能介绍

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

接口约束

如果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为绑定的后端服务器自动生成的memberID。
  • 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为绑定的后端服务器自动生成的memberID。

tenant_id

String

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

支持的最大字符长度：255

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",
        "address": "192.168.44.11", 
        "protocol_port": 88, 
        "operating_status": "ONLINE", 
        "id": "c0042496-e220-44f6-914b-e6ca33bab503"
    }
}

返回码

请参见状态码。

父主题： 后端云服务器