AddBackendServers - 负载均衡

说明如果一次请求中添加多个相同的ECS实例，只会取第一个，其他相同实例会被忽略。新增后端服务器不能与同监听下已有服务器重复，否则会报错。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
RegionId	String	否	cn-beijing	负载均衡实例所属地域的ID。您可以通过调用DescribeRegions获取地域ID。
Action	String	是	AddBackendServers	系统规定参数。取值：AddBackendServers。
LoadBalancerId	String	是	lb-2ze7o5h52g02kkzz******	负载均衡实例ID。
BackendServers	String	否	[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168..", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166..", "Port":"80","Description":"test-113" }]	要添加的后端服务器列表，包含以下参数： ServerId：String类型，必选，后端服务器的实例ID，分为ECS实例ID、ENI实例ID和ECI实例ID，当ServerId参数值为ENI实例ID或ECI实例ID时，Type参数值必选。 Weight：后端服务器的权重，取值：0~100。默认值：100。如果值为0，则不会将请求转发给该后端服务器。 Description：String类型，非必选，后端服务器描述，长度为1~80个字符，支持中文、字母、数字、短划线（-）、正斜线（/）、半角句号（.）和下划线（_）。 Type：后端服务器类型，取值： ecs：ECS实例（默认）。 eni：弹性网卡实例。 eci：弹性容器实例。说明只有性能保障型实例支持添加eni和eci类型的后端服务器。 ServerIp：ECS、ENI或者ECI的实例IP。 Port：用来接收请求的后端端口。示例说明如下：挂载ECS示例：`[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }]` 挂载ENI：`[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168..", "Port":"80","Description":"test-112" }]` 挂载ENI多IP：`[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168..", "Port":"80","Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166..", "Port":"80","Description":"test-113" }]` 挂载ECI：`[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168..", "Port":"80","Description":"test-114" }]` 说明必须是状态为运行中的后端服务器才可以加入负载均衡实例，每次调用最多可添加20个后端服务器。

返回数据


名称	类型	示例值	描述
LoadBalancerId	String	lb-2ze7o5h52g02kkzz****	负载均衡实例ID。
RequestId	String	34B82C81-F13B-4EEB-99F6-A048C67CC830	请求ID。
BackendServers	Array of BackendServer		后端服务器列表。
BackendServer
Type	String	ecs	后端服务器类型。取值： ecs：ECS实例（默认）。 eni：弹性网卡实例。 eci：弹性容器实例。
Weight	String	100	后端服务器的权重。取值：0~100。默认值：100。如果值为0，则不会将请求转发给该后端服务器。
Description	String	后端服务器	后端服务器描述。
ServerId	String	i-2zej4lxhjoq1icu*****	ECS、ENI、或者ECI实例ID。

示例

请求示例

http(s)://[Endpoint]/?RegionId=cn-beijing
&Action=AddBackendServers
&LoadBalancerId=lb-2ze7o5h52g02kkzz******
&BackendServers=[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168.**.**", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166.**.**", "Port":"80","Description":"test-113" }]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AddBackendServersResponse>
    <LoadBalancerId>lb-2ze7o5h52g02kkzz****</LoadBalancerId>
    <RequestId>34B82C81-F13B-4EEB-99F6-A048C67CC830</RequestId>
    <BackendServers>
        <Type>ecs</Type>
        <Weight>100</Weight>
        <Description>后端服务器</Description>
        <ServerId>i-2zej4lxhjoq1icu*****</ServerId>
    </BackendServers>
</AddBackendServersResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "LoadBalancerId" : "lb-2ze7o5h52g02kkzz****",
  "RequestId" : "34B82C81-F13B-4EEB-99F6-A048C67CC830",
  "BackendServers" : [ {
    "Type" : "ecs",
    "Weight" : "100",
    "Description" : "后端服务器",
    "ServerId" : "i-2zej4lxhjoq1icu*****"
  } ]
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidParameter	The specified load balancer does not support the network type of the ECS instance.	负载均衡实例不支持此种网络类型的ECS实例，请您换一种网络类型的ECS后再重试。
400	Mismatched.ZoneId	The zone of the server is not matched with the cloud box loadbalancer.	当前服务器的可用区与云盒实例可用区不匹配。
400	BackendServerProcessing	Backend Server is adding, please try again later.	后端服务器正在添加中，请稍后尝试。
400	InvalidBackendServers.ServerIpConflict	%s.	存在相同TunnelId和RsIp配置的后端服务器。
400	OperationUnsupported.AddBackendServers	This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.	SingleTunnel和AnyTunnel类型负载均衡实例不支持指定类型的后端服务器。
400	IncorrectStatus.RSByPassToas	%s.	指定后端服务器的BypassToa配置无效。
400	OperationFailed.ActionNotSupport	The loadbalancer does not support such action.	当前实例不支持该操作。
400	NetworkConflict	%s.	虚拟服务器组和ECS配置信息不一致。

访问错误中心查看更多错误码。