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个。 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个后端服务器。取值：是一个Json string，其结构是一个JsonList。一次请求中，List中的元素个数最多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		后端服务器列表。
BackendServer
ServerId	String	vm-236	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>
      <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"
        }
      ]
    }
  }
}

错误码

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