创建伸缩组
最近更新时间: 2024-10-18 10:38:33
1. 接口描述
接口请求域名： as.api3.fincloud.tencent.cn。
本接口（CreateAutoScalingGroup）用于创建伸缩组
默认接口请求频率限制：20次/秒。
接口更新时间：2023-03-03 11:45:31。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：CreateAutoScalingGroup |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-04-19 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| AutoScalingGroupName | 是 | 否 | String | 伸缩组名称，在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超55个字节。 |
| DefaultCooldown | 否 | 否 | Uint64 | 默认冷却时间，单位秒，默认值为300 |
| DesiredCapacity | 否 | 否 | Uint64 | 期望实例数，大小介于最小实例数和最大实例数之间 |
| LaunchConfigurationId | 是 | 否 | String | 启动配置ID |
| LoadBalancerIds | 否 | 否 | Array of String | 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 |
| MaxSize | 是 | 否 | Uint64 | 最大实例数，取值范围为0-2000。 |
| MinSize | 是 | 否 | Uint64 | 最小实例数，取值范围为0-2000。 |
| ProjectId | 否 | 否 | Uint64 | 项目ID |
| ForwardLoadBalancers | 否 | 否 | Array of ForwardLoadBalancer | 应用型负载均衡器列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 |
| SubnetIds | 否 | 否 | Array of String | 子网ID列表，VPC场景下必须指定子网。多个子网以填写顺序为优先级，依次进行尝试，直至可以成功创建实例。 |
| TerminationPolicies | 否 | 否 | Array of String | 销毁策略，目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE，默认取值为 OLDEST_INSTANCE。<br><br><li> OLDEST_INSTANCE 优先销毁伸缩组中最旧的实例。<br><br><li> NEWEST_INSTANCE，优先销毁伸缩组中最新的实例。 |
| VpcId | 是 | 否 | String | VPC ID，基础网络则填空字符串 |
| Zones | 否 | 否 | Array of String | 可用区列表，基础网络场景下必须指定可用区。多个可用区以填写顺序为优先级，依次进行尝试，直至可以成功创建实例。 |
| RetryPolicy | 否 | 否 | String | 重试策略，取值包括 IMMEDIATE_RETRY、 INCREMENTAL_INTERVALS、NO_RETRY，默认取值为 IMMEDIATE_RETRY。<br><br><li> IMMEDIATE_RETRY，立即重试，在较短时间内快速重试，连续失败超过一定次数（5次）后不再重试。<br><br><li> INCREMENTAL_INTERVALS，间隔递增重试，随着连续失败次数的增加，重试间隔逐渐增大，重试间隔从秒级到1天不等。<br><br><li> NO_RETRY，不进行重试，直到再次收到用户调用或者告警信息后才会重试。 |
| ZonesCheckPolicy | 否 | 否 | String | 可用区校验策略，取值包括 ALL 和 ANY，默认取值为ANY。<br><br><li> ALL，所有可用区（Zone）或子网（SubnetId）都可用则通过校验，否则校验报错。<br><br><li> ANY，存在任何一个可用区（Zone）或子网（SubnetId）可用则通过校验，否则校验报错。<br><br>可用区或子网不可用的常见原因包括该可用区CVM实例类型售罄、该可用区CBS云盘售罄、该可用区配额不足、该子网IP不足等。<br>如果 Zones/SubnetIds 中可用区或者子网不存在，则无论 ZonesCheckPolicy 采用何种取值，都会校验报错。 |
| Tags | 否 | 否 | Array of Tag | 标签描述列表。通过指定该参数可以支持绑定标签到伸缩组。同时绑定标签到相应的资源实例， |
| ServiceSettings | 否 | 否 | ServiceSettings | 服务设置，包括云监控不健康替换等服务设置。 |
| Ipv6AddressCount | 否 | 否 | Int64 | 实例具有IPv6地址数量的配置，取值包括 0、1，默认值为0。 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| AutoScalingGroupId | String | 伸缩组ID |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameterValue.OnlyVpc | |
| InvalidParameter.InScenario | |
| InvalidParameterValue.LbProjectInconsistent | |
| InvalidParameterValue.Range | |
| InvalidParameterValue.TooLong | |
| ResourceUnavailable.ProjectInconsistent | |
| InvalidParameterValue.GroupNameDuplicated | |
| LimitExceeded.AutoScalingGroupLimitExceeded | |
| LimitExceeded.MaxSizeLimitExceeded | |
| InvalidParameterValue.Size | |
| InvalidParameterValue.LbVpcInconsistent | |
| LimitExceeded.MinSizeLimitExceeded | |
| LimitExceeded | |
| InvalidParameterValue.CvmError | |
| InvalidParameterValue.LaunchConfigurationNotFound | |
| InvalidParameterValue.SubnetIds | |
| MissingParameter.InScenario | |
| ResourceUnavailable.LaunchConfigurationStatusAbnormal | |
| InvalidParameterValue.LimitExceeded | |
| InternalError | |
| InvalidParameterValue.ForwardLb | |
| ResourceNotFound.LoadBalancerNotFound |