更新时间:2022-03-31 GMT+08:00
分享

更新后端服务器

功能介绍

更新后端服务器。

接口约束

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

调试

您可以在API Explorer中调试该接口。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

member_id

String

后端服务器ID。

pool_id

String

后端服务器组ID。

project_id

String

项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

IAM鉴权Token

表3 请求Body参数

参数

是否必选

参数类型

描述

member

UpdateMemberOption object

后端服务器对象。

表4 UpdateMemberOption

参数

是否必选

参数类型

描述

admin_state_up

Boolean

后端云服务器的管理状态。取值:true、false。

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

请勿传入该字段。

name

String

后端云服务器名称。

最小长度:0

最大长度:255

weight

Integer

后端云服务器的权重,请求将根据pool配置的负载均衡算法和后端云服务器的权重进行负载分发。权重值越大,分发的请求越多。权重为0的后端不再接受新的请求。 取值:0-100,默认1。 使用说明:

  • 若所在pool的lb_algorithm取值为SOURCE_IP,该字段无效。

最小值:0

最大值:100

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

注:自动生成 。

member

Member object

后端服务器对象。

表6 Member

参数

参数类型

描述

id

String

后端服务器ID。

name

String

后端服务器名称。

project_id

String

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

pool_id

String

所在后端服务器组ID。

不支持该字段,请勿使用。

admin_state_up

Boolean

后端云服务器的管理状态。取值:true、false。

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

subnet_cidr_id

String

后端云服务器所在子网的IPv4子网ID或IPv6子网ID。

若所属的LB的跨VPC后端转发特性已开启,则该字段可以不传,表示添加跨VPC的后端服务器。此时address必须为IPv4地址,所在的pool的协议必须为TCP/HTTP/HTTPS。

使用说明:

  • 该子网和关联的负载均衡器的子网必须在同一VPC下。

protocol_port

Integer

后端服务器业务端口号。

最小值:1

最大值:65535

weight

Integer

后端云服务器的权重,请求将根据pool配置的负载均衡算法和后端云服务器的权重进行负载分发。权重值越大,分发的请求越多。权重为0的后端不再接受新的请求。 取值:0-100,默认1。 使用说明:

  • 若所在pool的lb_algorithm取值为SOURCE_IP,该字段无效。

最小值:0

最大值:100

address

String

后端服务器对应的IP地址。 使用说明:

  • 若subnet_cidr_id为空,表示添加跨VPC后端,此时address必须为IPv4地址。

  • 若subnet_cidr_id不为空,表示是一个关联到ECS的后端服务器。该IP地址可以是IPv4或IPv6。但必须在subnet_cidr_id对应的子网网段中。且只能指定为关联ECS的主网卡IP。

ip_version

String

当前后端服务器的IP地址版本,由后端系统自动根据传入的address字段确定。取值:v4、v6。

device_owner

String

设备所有者,取值:

  • 空,表示后端服务器未关联到ECS。

  • compute:{az_name},表示关联到ECS,其中{az_name}表示ECS所在可用区名。

不支持该字段,请勿使用。

device_id

String

关联的ECS ID,为空表示后端服务器未关联到ECS。

operating_status

String

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

  • ONLINE:后端云服务器正常。

  • NO_MONITOR:后端云服务器所在的服务器组没有健康检查器。

  • OFFLINE:后端云服务器关联的ECS服务器不存在或已关机。

loadbalancer_id

String

所属负载均衡器ID。

不支持该字段,请勿使用。

member_type

String

后端云服务器的类型。取值:

  • ip:跨VPC的member。

  • instance:关联到ECS的member。

instance_id

String

member关联的实例ID,空表示跨VPC场景的member。

请求示例

PUT https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/pools/36ce7086-a496-4666-9064-5ba0e6840c75/members/1923923e-fe8a-484f-bdbc-e11559b1f48f

{
  "member" : {
    "name" : "My member",
    "weight" : 10
  }
}

响应示例

状态码: 200

操作正常返回。

{
  "member" : {
    "name" : "My member",
    "weight" : 10,
    "admin_state_up" : false,
    "subnet_cidr_id" : "c09f620e-3492-4429-ac15-445d5dd9ca74",
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "address" : "120.10.10.16",
    "protocol_port" : 89,
    "id" : "1923923e-fe8a-484f-bdbc-e11559b1f48f",
    "operating_status" : "NO_MONITOR",
    "ip_version" : "v4"
  },
  "request_id" : "e7b569d4-15ad-494d-9dd9-8cd740eef8f6"
}

状态码

状态码

描述

200

操作正常返回。

错误码

请参见错误码

分享:

    相关文档

    相关产品

关闭导读