调用ModifyVServerGroupBackendServers替换服务器组中的后端服务器。
该接口只用于替换服务器中的后端服务器,如果您需要修改后端服务器的端口权重等配置,请参见SetVServerGroupAttribute。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyVServerGroupBackendServers |
要执行的操作。 取值:ModifyVServerGroupBackendServers。 |
RegionId | String | 是 | cn-hangzhou |
负载均衡实例的地域ID。 |
VServerGroupId | String | 是 | rsp-cige6j****** |
服务器组ID。 |
OldBackendServers | String | 否 | [{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"80","Description":"test-112" }] |
要被替换的后端服务器列表。 取值:是一个Json string,其结构是一个JsonList。一次请求中,List中的元素个数最多20个。
示例说明如下:
|
NewBackendServers | 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" }] |
新的后端服务器列表。 单次调用每个服务器组最多可调用20个后端服务器。 取值:是一个Json string,其结构是一个JsonList。一次请求中,List中的元素个数最多20个。
示例说明如下:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
VServerGroupId | String | rsp-cige6j****** |
服务器组ID。 |
BackendServers | Array |
后端服务器列表。 |
|
BackendServer | |||
ServerId | String | vm-236 |
ECS实例ID或ENI的实例ID。 |
Port | Integer | 70 |
后端服务器使用的端口。 |
Weight | Integer | 100 |
后端服务器的权重。 |
Description | String | 后端服务器描述。 |
后端服务器描述。 |
Type | String | ecs |
Type后端服务器类型,取值:
|
RequestId | String | 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ModifyVServerGroupBackendServers
&RegionId=cn-hangzhou
&VServerGroupId=rsp-cige6j******
&<公共请求参数>
正常返回示例
XML
格式
<ModifyVServerGroupBackendServersResponse>
<RequestId>9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C</RequestId>
<VServerGroupId>rsp-cige6j*****</VServerGroupId>
<BackendServers>
<BackendServer>
<ServerId>vm-400</ServerId>
<Port>80</Port>
<Weight>100</Weight>
</BackendServer>
<BackendServer>
<ServerId>vm-401</ServerId>
<Port>90</Port>
<Weight>100</Weight>
</BackendServer>
</BackendServers>
</ModifyVServerGroupBackendServersResponse>
JSON
格式
{
"ModifyVServerGroupBackendServersResponse": {
"RequestId": "9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C",
"VServerGroupId": "rsp-cige6j*****",
"BackendServers": {
"BackendServer": [
{
"ServerId": "vm-400",
"Port": "80",
"Weight": "100"
},
{
"ServerId": "vm-401",
"Port": "90",
"Weight": "100"
}
]
}
}
}
错误码
访问错误中心查看更多错误码。