1. 云计算教程网首页
  2. 阿里云

AttachVServerGroups

除通过 AttachLoadBalancers 添加负载均衡实例外,您还可以通过 AttachVServerGroups 添加负载均衡实例下的一个或者多个虚拟服务器组。

描述

由于负载均衡存在 ,向伸缩组添加虚拟服务器组时需要满足以下条件:

  • 负载均衡实例与伸缩组必须属于同一账号。
  • 负载均衡实例与伸缩组必须处于同一地域。
  • 负载均衡实例必须处于 运行中 状态。
  • 负载均衡实例至少配置有一个监听且必须开启健康检查。
  • 如果负载均衡实例与伸缩组的网络类型均为 VPC,必须处于同一 VPC。
  • 当伸缩组的网络类型为 VPC,负载均衡实例的网络类型为经典网络时,如果虚拟服务器组包含 VPC 实例,该实例必须与伸缩组处于同一 VPC。
  • 待添加虚拟服务器组必须属于对应的负载均衡实例。
  • 目前,伸缩组内虚拟服务器组的限额为 5。
    说明

    注意:确定伸缩组内虚拟服务器组的方式为:负载均衡实例 ID(LoadBalancerId)

    • 虚拟服务器组ID(VServerGroupId)
    • 虚拟服务器组端口号(Port) 。如果通过不同的端口号将同一虚拟服务器组添加至伸缩组,视为伸缩组内添加了多个虚拟服务器组。如果请求参数中存在重复的虚拟服务器组 ID
    • 端口号,默认使用最先配置的一组,忽略其余虚拟服务器组。

调试

前往【】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

伸缩组所属的地域ID,如 cn-hangzhou、cn-shanghai。更多详情,请参阅 。

ScalingGroupId String asg-****

伸缩组 ID。

Action String AttachVServerGroups

操作接口名,系统规定参数,取值: AttachVServerGroups。

ForceAttach Boolean false

是否将当前伸缩组内的 ECS 实例添加到新增的虚拟服务器组。

  • true:添加
  • false:不添加

默认值:false

VServerGroup.N.LoadBalancerId String lb-****

虚拟服务器组所属负载均衡实例的 ID。N 为负载均衡实例编号,取值范围:1~5。

VServerGroup.N.VServerGroupAttribute.N.Port Integer 22

弹性伸缩将 ECS 实例添加到虚拟服务器组时使用的端口号,取值范围:1~65535。

N 为负载均衡实例编号,取值范围:1~5。M 为负载均衡实例下虚拟服务器组的编号,取值范围:1~5。

VServerGroup.N.VServerGroupAttribute.N.VServerGroupId String rsp-****

虚拟服务器组 ID。N 为负载均衡实例编号,取值范围:1~5。M 为负载均衡实例下虚拟服务器组的编号,取值范围:1~5。

VServerGroup.N.VServerGroupAttribute.N.Weight Integer 100

弹性伸缩将 ECS 实例添加到虚拟服务器组时设置的权重,取值范围:0~100。

默认值:50。

N 为负载均衡实例编号,取值范围:1~5。M 为负载均衡实例下虚拟服务器组的编号,取值范围:1~5。

返回参数

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。无论调用接口成功与否,我们都会返回请求 ID。

示例

请求示例


http://ess.aliyuncs.com/?Action=AttachVServerGroups
&ScalingGroupId=asg-****
&RegionId=cn-hangzhou
&VServerGroup.1.LoadBalancerId=lb-****
&VServerGroup.1.VServerGroupAttribute.1.VServerGroupId=rsp-****
&VServerGroup.1.VServerGroupAttribute.1.Port=22
&VServerGroup.1.VServerGroupAttribute.1.Weight=100
&<公共请求参数>

正常返回示例

XML 格式

<AttachVServerGroupsResponse>
  <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</AttachVServerGroupsResponse>

JSON 格式

{
	"requestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HttpCode

错误码

错误信息

描述

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

您未授予弹性伸缩完整的Open API调用权限。

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

账号下不存在指定的伸缩组。

404

InvalidLoadBalancerId.NotFound

The load balancer “%s” does not exist.

账号下不存在指定的负载均衡实例。

400

InvalidLoadBalancerId.RegionMismatch

The load balancer “%s” and the specified scaling group are not in the same Region.

负载均衡实例与伸缩组不在同一地域。

400

IncorrectLoadBalancerStatus

The current status of the load balancer “%s” does not support this action.

当前负载均衡实例状态不支持此操作。

400

IncorrectLoadBalancerHealthCheck

The current health check type of the load balancer “%s” does not support this action.

当前负载均衡实例未开启健康检查。

400

InvalidLoadBalancerId.VPCMismatch

The specified virtual switch and the instance in the load balancer “%s” are not in the same VPC.

负载均衡实例与伸缩组不在同一VPC下。

400

InvalidVServerGroupId.ForLoadBalancer

Invalid VServerGroupId For LoadBalancer “%s”.

VServerGroupId对应的虚拟服务器组不属于指定的负载均衡实例。

400

QuotaExceeded.VServerGroup

VServerGroup quota exceeded in the specified scaling group.

当前伸缩组内可配置的虚拟服务器组个数达到上限。

发布者:lidazhuang,转转请注明出处:https://www.cms2.cn/aliyun/4569.html

发表评论

电子邮件地址不会被公开。 必填项已用*标注

联系我们

400-800-8888

在线咨询:点击这里给我发消息

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

QR code