调用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配置信息不一致。

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