调用AddBackendServers添加后端服务器。
说明
- API调用频率:100次/秒。
- 单用户调用频率:10次/秒。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AddBackendServers |
系统规定参数。取值:AddBackendServers。 |
LoadBalancerId | String | 是 | lb-5qzdmxefgrpxd7oz2mefonvtx |
负载均衡实例前端使用的端口。取值:1~65535。 |
BackendServers | Array | 是 |
添加的后端服务器列表,每次调用最多可添加20个后端服务器。 说明 后端服务器(ENS实例)必须是运行中才可以加入负载均衡实例。
|
|
ServerId | String | 是 | i-5uf6dwyzch3wly790**** |
ENS实例ID。 |
Weight | Integer | 否 | 100 |
后端服务器的权重。默认值:100,取值:0~100。 说明 取值为0,表示不会将请求转发给该后端服务器。
|
Type | String | 否 | ens |
后端服务器类型。取值: ens:ENS实例。 |
Ip | String | 否 | 192.168.0.1 |
后端服务器IP地址。 |
Port | Integer | 否 | 3309 |
负载均衡实例后端使用的端口。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
BackendServers | Array of BackendServer |
添加的后端服务器列表,每次调用最多可添加20个后端服务器。 说明 后端服务器(ENS实例)必须是运行中才可以加入负载均衡实例。
|
|
BackendServer | |||
ServerId | String | i-5uf6hj58zvml4ali8**** |
后端服务器的实例ID。 |
Weight | Integer | 100 |
后端服务器的权重。默认值:100,取值:0~100 。 说明 取值为0,表示不会将请求转发给该后端服务器。
|
Type | String | ens |
后端服务器类型。取值: ens:ENS实例。 |
Ip | String | 192.168.0.1 |
后端服务器IP地址。 |
Port | Integer | 0 |
负载均衡实例后端使用的端口。 |
示例
请求示例
https://ens.aliyuncs.com/?Action=AddBackendServers
&LoadBalancerId=lb-5qzdmxefgrpxd7oz2mefonvtx
&BackendServers=[{"ServerId":"i-5uf6dwyzch3wly790****","Weight":100,"Type":"ens","Ip":"192.168.0.1","Port":3309}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<AddBackendServersResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<BackendServers>
<ServerId>i-5uf6hj58zvml4ali8****</ServerId>
<Weight>100</Weight>
<Type>ens</Type>
<Ip>192.168.0.1</Ip>
<Port>0</Port>
</BackendServers>
</AddBackendServersResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"BackendServers" : [ {
"ServerId" : "i-5uf6hj58zvml4ali8****",
"Weight" : 100,
"Type" : "ens",
"Ip" : "192.168.0.1",
"Port" : 0
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InstanceNotFound | The input parameter instancdId that is not found. | 指定的InstanceId不存在。 |
400 | Missing%s | You must specify the parameter %s. | 参数为必填 |
400 | Invalid%s | The specified parameter %s is invalid. | 参数不正确 |
400 | NoPermission | Permission denied. | 没有足够的权限,请联系云账号管理员授予您相应权限。 |
访问错误中心查看更多错误码。