ModifyVServerGroupBackendServers - 传统型负载均衡CLB| 阿里云

该接口只用于替换服务器中的后端服务器，如果您需要修改后端服务器的端口权重等配置，请参见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" }]	要被替换的后端服务器列表，单次调用每个服务器组最多可包含20个后端服务器。取值： ServerId：String类型，必选，后端服务器的实例ID。 Port：Integer类型，必选，后端服务器使用的端口，取值范围：1~65535。 Weight：Integer类型，必选，后端服务器的权重，取值范围：0~100。 Description：String类型，非必选，后端服务器描述，长度为1~80个字符，允许包含字母、数字、短划线（-）、正斜线（/）、半角句号（.）和下划线（_），支持中文。 Type：String类型，表示后端服务器的实例类型，取值： ecs：ECS实例（默认）。 eni：弹性网卡实例。 ServerIp：ECS或者ENI的实例IP。示例说明如下：挂载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-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166..", "Port":"80","Description":"test-113" }]`
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个后端服务器。取值： ServerId：String类型，必选，后端服务器的实例ID。 Port：Integer类型，必选，后端服务器使用的端口，取值范围：1~65535。 Weight：Integer类型，必选，后端服务器的权重，取值范围：0~100。 Description：String类型，非必选，后端服务器描述，允许包含字母、数字、短划线（-）、正斜线（/）、半角句号（.）和下划线（_），支持中文。 Type：String类型，表示后端服务器的实例类型，取值： ecs： ECS实例（默认）。 eni：弹性网卡实例。 ServerIp：ECS或者ENI的实例IP。示例说明如下：挂载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-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166..", "Port":"80","Description":"test-113" }]`

返回数据


名称	类型	示例值	描述
VServerGroupId	String	rsp-cige6j****	服务器组ID。
BackendServers	Array of BackendServer		后端服务器列表。
BackendServer
ServerId	String	i-bp1ge5hrp****	ECS实例ID或ENI的实例ID。
Port	Integer	70	后端服务器使用的端口。
Weight	Integer	100	后端服务器的权重。
Description	String	后端服务器描述。	后端服务器描述。
Type	String	ecs	Type后端服务器类型，取值： ecs（默认）：ECS实例 eni：弹性网卡实例
RequestId	String	9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C	请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyVServerGroupBackendServers
&RegionId=cn-hangzhou
&VServerGroupId=rsp-cige6j****
&<公共请求参数>

正常返回示例

XML格式

<ModifyVServerGroupBackendServersResponse>
  <VServerGroupId>rsp-cige6j****</VServerGroupId>
  <RequestId>9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C</RequestId>
  <BackendServers>
        <BackendServer>
              <Type>ecs</Type>
              <Description>后端服务器描述。</Description>
              <ServerId>i-bp1ge5hrp****</ServerId>
              <Port>70</Port>
              <Weight>100</Weight>
        </BackendServer>
  </BackendServers>
</ModifyVServerGroupBackendServersResponse>

JSON格式

{
    "VServerGroupId": "rsp-cige6j****",
    "RequestId": "9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C",
    "BackendServers": {
        "BackendServer": {
            "Type": "ecs",
            "Description": "后端服务器描述。",
            "ServerId": "i-bp1ge5hrp****",
            "Port": 70,
            "Weight": 100
        }
    }
}

错误码

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