调用SetVServerGroupAttribute修改虚拟服务器组的配置。
该接口只能用于修改后端服务器的权重和虚拟服务器名称:
- 如果您需要修改后端服务器组,请参见接口ModifyVServerGroupBackendServers。
- 如果您需要添加后端服务器,请参见接口AddVServerGroupBackendServers。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SetVServerGroupAttribute |
要执行的操作。 取值:SetVServerGroupAttribute。 |
RegionId | String | 是 | cn-hangzhou |
负载均衡地域ID,不可更改。 |
VServerGroupId | String | 是 | rsp-cige6**** |
后端服务器组ID,不可更改。 |
VServerGroupName | String | 否 | Group1 |
虚拟服务器组名称,可自定义更改。 |
BackendServers | String | 否 | [{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.XX.XX.6", "Port":"80","Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.XX.XX.6", "Port":"80","Description":"test-113" }] |
虚拟服务器组列表,单次最多可添加20个后端服务器。
示例如下:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
VServerGroupId | String | rsp-cige6**** |
服务器组ID。 |
VServerGroupName | String | Group1 |
虚拟服务器组名称。 |
BackendServers | Array of BackendServer |
后端服务器列表。 |
|
BackendServer | |||
ServerId | String | i-bp1ek6yd7jvkx**** |
ECS实例ID或ENI实例ID。 |
Port | Integer | 70 |
后端服务器使用的端口。 |
Weight | Integer | 100 |
后端服务器的权重。 |
Description | String | 后端服务器组描述。 |
后端服务器组描述。 |
Type | String | ecs |
后端服务器类型,取值:
|
RequestId | String | 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=SetVServerGroupAttribute
&RegionId=cn-hangzhou
&VServerGroupId=rsp-cige6****
&<公共请求参数>
正常返回示例
XML
格式
<CreateLoadBalancerTCPListener>
<VServerGroupId>rsp-cige6****</VServerGroupId>
<RequestId>9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C</RequestId>
<VServerGroupName>Group1</VServerGroupName>
<BackendServers>
<BackendServer>
<Type>ecs</Type>
<Description>后端服务器组描述。</Description>
<ServerId>i-bp1ek6yd7jvkx****</ServerId>
<Port>70</Port>
<Weight>100</Weight>
</BackendServer>
</BackendServers>
</CreateLoadBalancerTCPListener>
JSON
格式
{
"VServerGroupId": "rsp-cige6****",
"RequestId": "9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C",
"VServerGroupName": "Group1",
"BackendServers": {
"BackendServer": {
"Type": "ecs",
"Description": "后端服务器组描述。",
"ServerId": "i-bp1ek6yd7jvkx****",
"Port": 70,
"Weight": 100
}
}
}
错误码
访问错误中心查看更多错误码。