文档首页 > > API参考> API(增强型)> 后端云服务器> 更新后端云服务器

更新后端云服务器

分享
更新时间: 2019/09/05 GMT+08:00

功能介绍

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

URI

PUT /v2.0/lbaas/pools/{pool_id}/members/{member_id}

表1 参数说明

参数

是否必选

参数类型

描述

pool_id

String

后端云服务器组ID。

member_id

String

后端云服务器ID。

接口约束

如果后端云服务器关联的负载均衡器的provisioning status不是ACTIVE,则不能更新该后端云服务器。

请求消息

表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.0/lbaas/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

提交反馈 取消

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

跳转到云社区