调用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" }] |
要添加的后端服务器列表,包含以下参数:
说明 只有性能保障型实例支持添加eni和eci类型的后端服务器。
示例说明如下:
说明 必须是状态为运行中的后端服务器才可以加入负载均衡实例,每次调用最多可添加20个后端服务器。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
LoadBalancerId | String | lb-2ze7o5h52g02kkzz**** |
负载均衡实例ID。 |
RequestId | String | 34B82C81-F13B-4EEB-99F6-A048C67CC830 |
请求ID。 |
BackendServers | Array of BackendServer |
后端服务器列表。 |
|
BackendServer | |||
Type | String | ecs |
后端服务器类型。取值:
|
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配置信息不一致。 |
访问错误中心查看更多错误码。