文档首页 > > API参考> API(共享型_企业项目)> 后端云服务器> 更新后端云服务器

更新后端云服务器

分享
更新时间: 2020/07/13 GMT+08:00

功能介绍

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

URI

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

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

操作用户的项目ID。

获取方法详见获取项目ID

pool_id

String

后端云服务器组id。

member_id

String

后端云服务器id。

说明:

此处并非服务器的ID,而是ELB为绑定的后端服务器自动生成的memberID。

接口约束

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

请求消息

表2 请求参数

参数

是否必选

参数类型

描述

member

Object

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

表3 member字段说明

参数

是否必选

参数类型

描述

name

String

后端云服务器的名称。

支持的最大字符长度:255

admin_state_up

Boolean

后端云服务器的管理状态:true/false。

只支持指定为true。

说明:

该字段虽然支持创建、更新,但实际取值决定于后端云服务器对应的弹性云服务器是否存在。若存在,该值为true,否则,该值为false。

weight

Integer

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

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

响应消息

表4 响应参数

参数

参数类型

描述

member

Object

member对象。详见表5

表5 member字段说明

参数

参数类型

描述

id

String

后端云服务器的 ID。

tenant_id

String

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

支持的最大字符长度:255

project_id

String

后端云服务器所在的项目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。

说明:

该字段虽然支持创建、更新,但实际取值决定于后端云服务器对应的弹性云服务器是否存在。若存在,该值为true,否则,该值为false。

weight

Integer

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

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

operating_status

String

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

  • ONLINE:健康检查在线,后端服务正常。
  • OFFLINE:健康检查离线,后端服务异常,负载均衡器不再向异常的后端发送流量。
  • NO_MONITOR:无检查检查。未创建检查检查或健康检查的admin_state_up字段为false。
  • 支持的最大字符长度:16

示例

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

返回码

请参见共享型负载均衡返回码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问