创建一个伸缩组,创建成功的伸缩组默认选择发送伸缩活动成功和失败的消息通知。关于消息通知。
您的账号首次使用弹性伸缩服务,且通过API调用时,平台会为您自动创建“跨服务访问授权”,允许弹性伸缩服务使用云服务器等产品或其他火山引擎产品使用弹性伸缩服务。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateScalingGroup | 要执行的操作,取值:CreateScalingGroup。 |
Version | String | 是 | 2020-01-01 | API的版本,取值:2020-01-01。 |
SubnetIds.N | Array of String | 是 | subnet-24sdlkdplsjkdjd**** | 伸缩组中实例主网卡的子网ID列表。您可以调用DescribeSubnets接口查询子网ID。
|
DBInstanceIds.N | Array of String | 否 | mysql-42b38c769c4b | RDS数据库实例的ID。
说明 伸缩组关联RDS数据库实例为邀测功能,如需使用,请联系客户经理申请。 |
ServerGroupAttributes.N.ServerGroupId | Array of String | 否 | rsp-12b2z5fnxvhts17q7y2fj**** | 负载均衡后端服务器组的ID。您可以调用DescribeServerGroups接口查询后端服务器组ID。
|
ClientToken | String | 否 | 333456899ff**** | 保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。取值: |
LaunchTemplateId | String | 否 | lt-yc5kwj1di33uw1qj**** | 实例启动模板ID,配置后表示选择启动模版作为伸缩配置来源。 |
LaunchTemplateVersion | String | 否 | Default | 实例启动模板的版本。取值:
说明 本参数仅当LaunchTemplateId参数存在取值时生有效。 |
LaunchTemplateOverrides.N.InstanceType | Array of String | 否 | ecs.g2a.large | 指定实例规格。
说明 本参数仅当LaunchTemplateId参数存在取值时生有效。 |
ScalingMode | String | 否 | release | 伸缩组的实例回收模式,取值:
|
Tags.N.Key | Array of String | 否 | k1 | 用户标签的标签键。
命名规则如下:
|
Tags.N.Value | Array of String | 否 | v1 | 用户标签的标签值。
命名规则如下:
|
HealthCheckType | String | 否 | ECS | 伸缩组的健康检查方式。取值:
|
InstancesDistribution.OnDemandBaseCapacity | Integer | 否 | 200 | 伸缩组中按量计费实例个数的最小值,取值范围:0~2000。当组中按量计费实例个数少于该值时,将优先创建按量计费的实例。 说明 该参数仅当伸缩组绑定的伸缩配置来源的计费类型为抢占式类型时生效,且该参数不影响最终创建的实例数量,实例数量仍有最大/最小/期望实例数限制。 |
ProjectName | String | 否 | default | 伸缩组所属项目,默认为空。一个资源只能归属于一个项目。
|
InstancesDistribution.OnDemandPercentageAboveBaseCapacity | Integer | 否 | 0 | 伸缩组满足最小按量实例数要求后,超出的实例中按量实例应占的比例,取值范围:0~100。 说明 该参数仅当伸缩组绑定的伸缩配置来源的计费类型为抢占式类型时生效。 |
ServerGroupAttributes.N.Type | Array of String | 否 | CLB | 负载均衡服务器组类型:
|
InstancesDistribution.SpotInstanceRemedy | Boolean | 否 | false | 是否允许抢占式实例到期替换。开启则表示在抢占式实例被回收前5分钟左右,伸缩组将主动新建新的抢占式实例替换掉当前抢占式实例。取值:
|
InstancesDistribution.CompensateWithOnDemand | Boolean | 否 | false | 当因价格、库存等原因无法创建足够的抢占式实例时,是否允许使用按量实例补充抢占式容量。取值:
|
LaunchTemplateOverrides.N.PriceLimit | Array of Float | 否 | 0.001 | 指定抢占式实例规格每小时的最高价格。
说明 本参数仅当 |
DefaultCooldown | Integer | 否 | 300 | 执行一次伸缩活动(添加或移出ECS实例)结束后的冷却时间。冷却时间内,该伸缩组不执行其它的伸缩活动,仅针对云监控报警任务触发的伸缩活动和伸缩规则有效。 |
DesireInstanceNumber | Integer | 否 | -1 | 伸缩组中期望运行的实例个数,更多介绍请参见 期望实例数。取值:
|
InstanceTerminatePolicy | String | 否 | OldestScalingConfigurationWithOldestInstance | 实例移除策略,取值:
|
MaxInstanceNumber | Integer | 是 | 10 | 伸缩组中实例个数的最大值,默认取值0 ~ 100。 |
MinInstanceNumber | Integer | 是 | 0 | 伸缩组中实例个数的最小值,默认取值0 ~ 100。 |
MultiAZPolicy | String | 否 | PRIORITY | 扩缩容策略,如果您选择了多个子网,需配置本参数。取值:
说明 选择策略后的实例扩缩容情况请参见创建伸缩组中的“扩缩容策略”参数说明。 |
ScalingGroupName | String | 是 | scaling-group-test | 伸缩组名称,同一地域下伸缩组名称唯一,取值:
|
ServerGroupAttributes.N.Port | Array of Integer | 否 | 80 | 负载均衡后端服务器组中服务器的端口号。
|
ServerGroupAttributes.N.Weight | Array of Integer | 否 | 20 | 负载均衡后端服务器组中服务器的权重。
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ScalingGroupId | String | scg-ybmssdnnhn5pkgyd**** | 伸缩组ID。 |
GET /?Action=CreateScalingGroup&MaxInstanceNumber=10&MinInstanceNumber=0&ScalingGroupName=scaling-group-test&SubnetIds.1=subnet-24sdlkdplsjkdjd****&Version=2020-01-01 HTTP/1.1 Host: open.volcengineapi.com X-Date: 20240507T092442Z Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240507/cn-beijing/auto_scaling/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{ "ResponseMetadata": { "RequestId": "20240507172628156000045004B36439", "Version": "2020-01-01", "Service": "auto_scaling", "Region": "cn-beijing" }, "Result": { "ScalingGroupId": "scg-ybmssdnnhn5pkgyd****" } }
您可访问公共错误码,获取更多错误码信息。