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
微信扫一扫
相关推荐
-
DescribeNotificationTypes
查询弹性伸缩事件及资源变化通知类型（DescribeNotificationTypes）。 请求参数 名称 类型 是否必选 描述 Action String 是 系统规定参数。取值：DescribeNotificationTypes。 返回参数 名称 类型 描述 RequestI…
-
阿里云弹性伸缩产品有什么优势？应用场景有哪些？
弹性伸缩自动为您调整弹性计算资源大小，以满足您业务需求的变化。 弹性伸缩根据您设置的伸缩规则，在业务需求增长时自动为您增加ECS实例以保证计算能力，在业务需求下降时自动减少ECS实例以节约成本。 说明 您需要提前设置触发弹性伸缩的条件。本文示例中，监控项为伸缩组内ECS实例的vC…
-
阿里云弹性伸缩提示客户端错误
本文介绍客户端错误信息。 HttpCode 错误码 错误信息 描述 400 MissingParameter The input parameter <parameter name> that is mandatory for processing this requ…
-
伸缩模式
本文主要介绍弹性伸缩的伸缩模式。 定时模式：您自定义自动伸缩发生的时间和频率，如每天 13：00增加 ECS 实例。 动态模式：基于云监控性能指标（如 CPU 利用率），自动增加或减少 ECS 实例。 固定数量模式：通过设置 最小实例数 （MinSize），即健康运行的ECS 实…
-
伸缩活动的流程
本文主要介绍弹性伸缩的伸缩活动流程。 伸缩活动的生命周期为判断伸缩组的健康状态和边界条件步骤与启动 cooldown 步骤之间的所有活动。 伸缩组自动伸缩 自动扩展 判断伸缩组的健康状态和边界条件。 分配 ActivityId 和执行伸缩活动。 创建 ECS 实例。 修改 Tot…
-
设置实例备用状态
本文介绍如何设置实例备用状态。 弹性伸缩支持设置ECS实例备用状态（Standby）。我们不会检查处于备用状态的ECS实例健康状态，也不会释放ECS实例。 功能特性 设置ECS实例备用状态后： ECS实例保持备用状态直至您使其退出备用状态。 弹性伸缩不会管理ECS实例的生命周期，…
