CreateScalingGroup
创建一个伸缩组（CreateScalingGroup）。伸缩组是具有相同应用场景的 ECS 实例集合，伸缩组有最大 ECS 实例数、最小 ECS 实例数、移出策略、冷却时间、关联的负载均衡实例和关联的 RDS 实例等属性。
描述
-
伸缩组、关联的负载均衡实例和关联的 RDS 实例必须在同一个地域。更多详情，请参阅 。
-
您最多能在同一个账号的一个地域下创建 50 个伸缩组。
-
伸缩组创建成功后，伸缩组不会立即生效。您需要启用伸缩组（
EnableScalingGroup）后，才能触发伸缩活动和接受伸缩规则。 -
如果在伸缩组中指定了负载均衡实例：
- 指定的负载均衡实例必须是 运行中（active） 状态。
- 伸缩组自动将加入伸缩组的 ECS 实例添加到指定的负载均衡实例中。
- 指定的负载均衡实例所有配置的监听端口必须开启健康检查，否则创建失败。
- 加入负载均衡实例的 ECS 实例权重默认为 50。
-
如果在伸缩组中指定了 RDS 实例：
- 指定的 RDS 实例必须是 运行中（running）状态。
- 伸缩组自动将加入伸缩组的 ECS 实例的内网 IP 添加到指定的 RDS 实例的访问白名单当中。
- 指定的 RDS 实例访问白名单的 IP 数不能超过上限值。更多详情，请参阅 RDS 。
请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 系统规定参数。取值：CreateScalingGroup。 |
| RegionId | String | 是 | 伸缩组所属的地域 ID。更多详情，请参阅 。 |
| MaxSize | Integer | 是 | 伸缩组内 ECS 实例台数的最大值，取值范围：[0, 1000]。 当伸缩组内 ECS 实例数大于 MaxSize 时，弹性伸缩会自动移出 ECS 实例。 |
| MinSize | Integer | 是 | 伸缩组内 ECS 实例台数的最小值，取值范围：[0, 1000] 。当伸缩组内 ECS 实例数小于 MinSize 时，弹性伸缩会自动创建 ECS 实例。 |
| ScalingGroupName | String | 否 |
伸缩组的显示名称，不能与您当前地域下的伸缩组重名。长度为 [2, 40] 个英文或中文字符，以数字、大小字母或中文开头，可包含数字、下划线（_）、连字符（-）和小数点（.）。 默认值：伸缩组 ID |
| DefaultCooldown | Integer | 否 |
一次伸缩活动（添加或移出 ECS 实例）结束后的一段冷却时间。取值范围：[0, 86400]，单位：秒。 默认值：300 冷却时间内，该伸缩组不执行其它的伸缩活动。目前，仅针对 报警任务触发的伸缩活动有效。 |
| RemovalPolicy.N | String | 否 |
移出 ECS 实例的伸缩组策略，更多详情，请参阅 。N的取值范围 [1,2]。取值范围：
默认值：OldestScalingConfiguration 和 OldestInstance |
| LoadBalancerIds | String | 否 | 负载均衡实例 ID。取值可以由多台负载均衡实例 ID 组成一个 JSON 数组，格式为 [“lb-idx”, “lb-idy”, … “lb-idz”]，最多支持 5 个 ID，ID 之间用半角逗号（,）隔开。 |
| VServerGroup.N.LoadBalancerId | String | 否 | 虚拟服务器组所属负载均衡实例的ID。
更多信息，请参考 。 |
| VServerGroup.N.VServerGroupAttribute.M.VServerGroupId | String | 否 | 虚拟服务器组ID。
更多信息，请参考 。 |
| VServerGroup.N.VServerGroupAttribute.M.Port | Integer | 否 | 弹性伸缩将ECS实例添加到虚拟服务器组时使用的端口号，取值范围：1-65535。
更多信息，请参考 。 |
| VServerGroup.N.VServerGroupAttribute.M.Weight | Integer | 否 | 弹性伸缩将ECS实例添加到虚拟服务器组时设置的权重，取值范围：0-100。
默认值：50。 更多信息，请参考 。 |
| DBInstanceIds | String | 否 | RDS 实例 ID。取值可以由多台 RDS 实例 ID 组成一个 JSON 数组，格式为 [“rm-idx”, “rm-idy”, … “rm-idz”]，最多支持 8 个 ID，ID 之间用半角逗号（,）隔开。 |
| VSwitchId | String | 否 | 创建 VPC 类型的伸缩组时，指定的虚拟交换机 ID。 |
| VSwitchIds.N | String | 否 |
一台或多台虚拟交换机 ID，N 的取值范围为 [1, 5]。如果您使用了 VSwitchIds.N 参数，VSwitchId 参数将被忽略。
|
| ScalingPolicy | String | 否 | 指定伸缩组的回收模式，可选值：
关于被移出实例的动作，请参阅 。 |
| MultiAZPolicy | String | 否 |
多可用区伸缩组 ECS 实例扩缩容策略。取值范围：
默认值：PRIORITY |
| LaunchTemplateId | String | 否 | 实例启动模板 ID，用于指定伸缩组从实例启动模板获取启动配置信息。 |
| LaunchTemplateVersion | String | 否 | 实例启动模板采用版本，可选值：
|
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| ScalingGroupId | String | 伸缩组 ID。 |
示例
请求示例
http://ess.aliyuncs.com/?Action=CreateScalingGroup
&RegionId=cn-qingdao
&MaxSize=20
&MinSize=2
&LoadBalancerId=147b46d767c-cn-qingdao-cm5-a01
&DBInstanceId.1=rdszzzyyunybaeu
&DBInstanceId.2=rdsia3u3yia3u3y
&<公共请求参数>
正常返回示例
XML 格式
<CreateScalingGroupResponse>
<ScalingGroupId>dP8VqSd9ENXPc0ciVmbcrBT1</ScalingGroupId>
<RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
</CreateScalingGroupResponse>
JSON 格式
{
"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
"ScalingGroupId": "dP8VqSd9ENXPc0ciVmbcrBT1"
}
错误码
以下为 CreatScalingGroup 接口的特有错误码。对于所有接口的通用性错误，请参考 或 。
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | IncorrectDBInstanceStatus | The current status of DB instance “XXX” does not support this action. | 指定的 RDS 实例必须是 运行中 状态。 |
| 400 | IncorrectLoadBalancerHealthCheck | The current health check type of specified load balancer does not support this action. | 指定的负载均衡实例必须开启健康检查。 |
| 400 | IncorrectLoadBalancerStatus | The current status of the specified load balancer does not support this action. | 指定的负载均衡实例必须是启用状态。 |
| 400 | IncorrectVSwitchStatus | The current status of virtual switch does not support this operation. | 虚拟交换机不可用，无法创建 ECS 实例。 |
| 400 | InvalidDBInstanceId. RegionMismatch | DB instance “XXX” and the specified scaling group are not in the same Region. | 指定的 RDS 实例与伸缩组必须在同一地域。 |
| 400 | InvalidLoadBalancerId.IncorrectAddressType | The current address type of specified load balancer does not support this action. | 指定虚拟交换机后，负载均衡实例为私网类型。更多详情，请参阅 。 |
| 400 | InvalidLoadBalancerId.IncorrectInstanceNetworkType | The network type of the instance in specified Load Balancer does not support this action. | 指定的负载均衡实例内搭载的 ECS 实例的网络类型与伸缩组的网络类型必须一致。 |
| 400 | InvalidLoadBalancerId.RegionMismatch | The specified Load Balancer and the specified scaling group are not in the same Region. | 指定的负载均衡实例与伸缩组必须在同一地域。 |
| 400 | InvalidLoadBalancerId.VPCMismatch | The specified virtual switch and the instance in specified Load Balancer are not in the same VPC. | 伸缩组内的负载均衡实例搭载的 ECS 实例与虚拟交换机应该在同一个 VPC 中。 |
| 400 | InvalidParameter | The specified value of parameter “ScalingPolicy” is not valid. | 指定的回收模式参数不存在。 |
| 400 | InvalidParameter.Conflict | The value of parameter <parameter name” and parameter <parameter name” are conflict. | 指定的 MinSize 不能大于 MaxSize。 |
| 400 | InvalidScalingGroupName.Duplicate | The specified value of parameter <parameter name” is duplicated. | 伸缩组名已存在。 |
| 400 | QuotaExceeded.DBInstanceSecurityIP | Security IP quota exceeded in DB instance “XXX”. | 指定的 RDS 实例访问白名单的 IP 个数达到上限。 |
| 400 | QuotaExceeded.PrivateIpAddress | Private IP address quota exceeded in the specified virtual switch. | 虚拟交换机无法再分配多余的私有 IP 地址。 |
| 400 | QuotaExceeded.ScalingGroup | Scaling group quota exceeded. | 用户的伸缩组使用个数达到上限。 |
| 400 | QuotaExceeded.VPCInstance | Instance quota exceeded in the specified VPC. | 该 VPC 内的实例数超过数量限制。 |
| 404 | InvalidDBInstanceId.NotFound | DB instance “XXX” does not exist. | 指定的 RDS 实例不存在。 |
| 404 | InvalidLoadBalancerId.NotFound | The specified Load Balancer does not exist. | 指定的负载均衡实例不存在。 |
| 404 | InvalidRegionId.NotFound | The specified region does not exist. | 指定的地域不存在。 |
| 404 | InvalidVSwitchId.NotFound | The specified virtual switch does not exist. | 指定的虚拟交换机不存在。 |
| 400 | LaunchTemplateVersionSet.NotFound | The specific version of launch template is not exist. | 实例启动模板指定版本不存在。 |
| 400 | LaunchTemplateSet.NotFound | The specified launch template set is not found. | 指定实例启动模板不存在。 |
| 400 | TemplateMissingParameter.ImageId | The input parameter “ImageId” that is mandatory for processing this request is not supplied. | 实例启动模板指定版本缺少镜像信息。 |
| 400 | TemplateMissingParameter.InstanceTypes | The input parameter “InstanceTypes” that is mandatory for processing this request is not supplied. | 实例启动模板指定版本缺少实例规格信息。 |
| 400 | TemplateMissingParameter.SecurityGroup | The input parameter “SecurityGroup” that is mandatory for processing this request is not supplied. | 实例启动模板指定版本缺少安全组信息。 |
| 400 | TemplateVersion.NotNumber | The input parameter “LaunchTemplateVersion” is supposed to be a string representing the version number. | 指定实例启动模板固定版本号为非数字。 |
发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4581.html
微信扫一扫
相关推荐
-
AttachInstances
往指定的伸缩组添加ECS实例。 描述 加入的ECS实例的限定条件包括： 加入的ECS实例必须与伸缩组在同一个地域。 加入的ECS实例必须是running状态。 加入的ECS实例不能已加入到其它伸缩组中。 加入的ECS实例支持包年包月和按量付费两种类型。 如果伸缩组指定Vswitc…
-
CreateScalingGroup
创建一个伸缩组（CreateScalingGroup）。伸缩组是具有相同应用场景的 ECS 实例集合，伸缩组有最大 ECS 实例数、最小 ECS 实例数、移出策略、冷却时间、关联的负载均衡实例和关联的 RDS 实例等属性。 描述 伸缩组、关联的负载均衡实例和关联的 RDS 实例必…
-
注意事项
本文主要介绍弹性伸缩相关注意事项。 伸缩规则 在计算和执行过程中，伸缩规则可以根据伸缩组的 MinSize、MaxSize 进行自动调整其需要增加或减少的 ECS 实例数（例如：伸缩规则中指定将伸缩组的 ECS 实例数调整至 50 台，但伸缩组 MaxSize 只有 45 台，则…
-
伸缩模式
本文主要介绍弹性伸缩的伸缩模式。 定时模式：您自定义自动伸缩发生的时间和频率，如每天 13：00增加 ECS 实例。 动态模式：基于云监控性能指标（如 CPU 利用率），自动增加或减少 ECS 实例。 固定数量模式：通过设置 最小实例数 （MinSize），即健康运行的ECS 实…
-
弹性伸缩报警任务
本文主要介绍弹性伸缩报警任务。 弹性伸缩（Auto Scaling）报警任务是弹性伸缩与云监控服务（CMS）深度合作，提供的一种动态管理伸缩组的方式，类似于弹性伸缩定时任务，弹性伸缩报警任务通过触发您指定的伸缩规则来执行伸缩活动，达到调整伸缩组内实例个数的目的。 定时任务可以在您…
-
冷却时间
本文主要介绍弹性伸缩的冷却时间。 冷却时间指成功执行伸缩活动后的一段锁定时间。您可以通过以下两种方式配置冷却时间： 在伸缩组中配置默认冷却时间，默认冷却时间不能为空，请参照 。 在伸缩规则中配置冷却时间，如果不配置，将使用默认冷却时间，请参照 。 说明 如果同时在伸缩组和伸缩规则…
