弹性伸缩
弹性伸缩
文档指南
请输入
- 文档首页
弹性伸缩API参考伸缩配置ModifyScalingConfiguration - 修改一个伸缩配置
复制全文
下载 pdfModifyScalingConfiguration - 修改一个伸缩配置
文档反馈
问问助手调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ModifyScalingConfiguration
要执行的操作，取值：ModifyScalingConfiguration。
Version string 必选 示例值：2020-01-01
API的版本，取值：2020-01-01。
ScalingConfigurationId string 必选 示例值：scc-ybmt16auaugh9zfy****
Ipv6AddressCount integer 可选 示例值：0
是否为实例网卡分配IPv6地址。取值：
- 0：不分配IPv6地址。
- 1：分配IPv6地址，系统自动为您分配IPv6网段。
Eip.SecurityProtectionInstanceId integer 可选 示例值：193
安全防护包的ID。
说明
当Eip.SecurityProtectionTypes.N不为空时，本参数必填。
HpcClusterId string 可选 示例值：hpcCluster-ycdj7d9ios38dfny****
实例所属的高性能计算集群的ID。
仅当InstanceTypes.N指定为“高性能计算GPU型”时有效。
Tags string 可选 示例值："k1":"v1"
伸缩配置创建实例的标签。标签以键值对方式传入，最多传入20组标签。Key命名规则如下：
- Key命名规则如下：
- 不能以volc:或sys:的任意大小写组合开头。
说明
volc:或sys:开头为系统预留标签键，禁止创建。
- 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
- 长度限制在1～128个字符之间。
- Value命名规则如下：
- 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
- 允许为空，长度限制在0～256个字符之间。
SpotStrategy string 可选 示例值：NoSpot
实例的抢占策略。取值：
- NoSpot：表示创建正常按量付费实例。
- SpotAsPriceGo：表示系统自动出价，跟随当前市场实际价格的抢占式实例。
- SpotWithPriceLimit：表示需要设置出价上限的抢占式实例。
Eip.SecurityProtectionTypes.N string[] 可选 示例值：AntiDDoS_Enhanced
公网IP的安全防护类型。
- 参数 - N：表示安全防护类型的序号，当前仅支持取1。
- 取值：
- AntiDDoS_Enhanced：申请增强防护类型的公网IP（可加入到DDoS原生防护实例）。
- 不填则表示基础防护类型的公网IP。
SecurityGroupIds.N string[] 可选 示例值：sg-3ti78x9h8t4bw*****
- 参数 - N：表示主网卡关联的安全组的序号，最多支持同时绑定5个安全组，取值：1 ～ 5。
- 参数 - SecurityGroupId：表示主网卡关联的第N个安全组的ID。
- 多个安全组ID之间用&分隔。
ProjectName string 可选 示例值：default
伸缩配置创建的实例所属项目。一个资源只能归属于一个项目。
- 只能包含字母、数字、下划线“_”、点“.”和中划线“-”。
- 长度限制在64个字符以内。
Eip.BandwidthPackageId string 可选 示例值：bwp-2zeo05qre24nhrqpy****
- 二者的安全防护类型相同。
- 二者的线路类型相同。
- 共享带宽包为IPv4类型。
InstanceTypeOverrides.N.InstanceType string[] 可选 示例值：ecs.g2i.large
指定抢占式实例的规格。
- 参数 - N：表示实例规格的序号，取值为1 ～ 10。
- 取值 - InstanceType：表示抢占式实例的规格。
- 多个规格之间用&分隔。
说明
本参数仅当SpotStrategy取值为SpotWithPriceLimit时生效。
InstanceTypeOverrides.N.PriceLimit float[] 可选 示例值：0.01
指定抢占式实例规格每小时的最高价格。
- 参数 - N：表示实例规格的序号，取值为1 ～ 10。
- 取值 - PriceLimit：表示抢占式实例规格每小时的最高价格。取值：大于0，且最大不超过3位小数。
- 多个价格之间用&分隔。
说明
本参数仅当SpotStrategy取值为SpotWithPriceLimit时生效。
KeyPairName string 可选 示例值：kp-test-123
如果同时设置了KeyPairName和Password，则仅生效KeyPairName。
Volumes.N.ExtraPerformanceTypeId string[] 可选 示例值：Volumes.2.ExtraPerformanceTypeId=IOPS
通过此参数可为云盘购买额外性能，仅ESSD FlexPL支持。
- 参数 - N：表示云盘的序号，序号为“1”表示系统盘，序号为“2”或大于“2”表示数据盘，仅数据盘支持额外性能包。取值：2～16
- 取值 -ExtraPerformanceTypeId 表示第N个云盘的额外性能包类型：
- IOPS:IOPS型，使用ExtraPerformanceIOPS参数
- Balance: 均衡型，使用ExtraPerformanceIOPS参数
- Throughput：吞吐量型，使用ExtraPerformanceThroughputMB参数
Volumes.N.ExtraPerformanceIOPS integer[] 可选 示例值：Volumes.2.ExtraPerformanceIOPS=100
通过此参数可配置云盘额外性能包IOPS性能大小，仅ESSD FlexPL支持。
- 参数 - N：表示云盘的序号，序号为“1”表示系统盘，序号为“2”或大于“2”表示数据盘，仅数据盘支持额外性能包。取值：2～16
- 取值 -ExtraPerformanceIOPS 表示第N个云盘的额外性能包IOPS大小：
- IOPS: 1-50000
- Balance: 1-50000
Volumes.N.ExtraPerformanceThroughputMB integer[] 可选 示例值：Volumes.2.ExtraPerformanceThroughputMB=100
通过此参数可配置云盘额外性能包吞吐性能大小，单位MB/s，仅ESSD FlexPL支持。
- 参数 - N：表示云盘的序号，序号为“1”表示系统盘，序号为“2”或大于“2”表示数据盘，仅数据盘支持额外性能包。取值：2～16
- 取值 -ExtraPerformanceThroughputMB 表示第N个云盘的额外性能包吞吐大小：
- Throughput：1-650
Eip.ReleaseWithInstance boolean 可选 示例值：false
公网IP是否随实例删除。
- true：公网IP随实例删除。
- false：公网IP不随实例删除。
Eip.Bandwidth integer 可选 示例值：1
公网IP的带宽峰值，单位：Mbps。取值：
- 当Eip.BillingType取值为PostPaidByBandwidth时，取值为1 ～ 500。
- 当Eip.BillingType取值为PostPaidByTraffic时，取值为1 ～ 200。
说明
如果您指定的伸缩配置中已配置公网IP，此时指定本参数为0值，则表示删除公网IP配置；如果未配置公网IP，那么配置Eip.Bandwidth、Eip.ISP、Eip.BillingType中的任意一项后，均可以为伸缩配置添加公网IP配置，未配置参数取默认值。
Eip.BillingType string 可选 示例值：PostPaidByBandwidth
公网IP的计费类型，取值：
- PostPaidByBandwidth：按量计费-按带宽上限计费。
- PostPaidByTraffic：按量计费-按实际流量计费。
说明
如果您需要使实例在加入伸缩组时自动分配公网IP，则必须至少配置Eip.Bandwidth、Eip.ISP、Eip.BillingType中的任意一项，均不配置则表示不分配公网IP。
Eip.ISP string 可选 示例值：BGP
线路类型，取值：
- BGP：BGP线路。
- 若您的账号已申请使用静态单线，ISP还可以传入ChinaMobile（表示中国移动）、ChinaTelecom（表示中国电信）、ChinaUnicom（表示中国联通）。
说明
如果您需要使实例在加入伸缩组时自动分配公网IP，则必须至少配置Eip.Bandwidth、Eip.ISP、Eip.BillingType中的任意一项，均不配置则表示不分配公网IP。
HostName string 可选 示例值：instance-host-name
实例的主机名。取值：
- Linux实例
- 允许使用点号分隔字符成多段，每段中允许使用字母、数字或中划线“-”。
- 不能以点号“.”或中划线“-”开头或结尾，且不能连续使用点号“.”或中划线“-”。
- Linux系统的主机名长度限制为2～63个字符。
- Windows实例
- 允许使用字母、数字或中划线“-”，不能完全是数字。
- 不能以中划线“-”开头或结尾，且不能连续使用中划线“-”。
- Windows系统的主机名长度限制在2～15个字符。
说明
ImageId string 可选 示例值：image-ybmhzqo8u4l8j1ii****
InstanceDescription string 可选 示例值：云服务器实例。
实例的描述，取值：
- 不能以数字、中划线开头。
- 只能包含中文、字母、数字、下划线和中划线。
- 长度限制在0 ~ 255之间。
InstanceName string 可选 示例值：instance-test
实例的名称，取值：
- 以字母或中文开头。
- 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。
- 长度限制为1～128个字符。
说明
InstanceTypes.N string[] 可选 示例值：ecs.g1.large
Password string 可选 示例值：password@123
使用“密码”方式登录实例时，请设置root登录密码：
- 长度限制在8 ～ 30之间
- 密码只能由大写字母、小写字母、数字和特殊字符组成，且必须包含至少三项
- 特殊字符可以使用：`~!@#$%^&*()_-+= |
- 不能以“/”和“$6$”开头
ScalingConfigurationName string 可选 示例值：scaling-config-test
伸缩配置的名称，在同一地域下同一伸缩组内伸缩配置名称唯一。取值:
- 只能以中文、字母开头。
- 只能包含中文、字母、数字、下划线和中划线。
- 长度限制为1 ~ 128个字符。
- 暂不支持特殊字符。
SecurityEnhancementStrategy string 可选 示例值：Active
是否开启安全加固，取值：
- Active：开启安全加固，仅对公共镜像生效。
- InActive：关闭安全加固，对所有镜像生效。
UserData string 可选 示例值：ZWNobyBoZWxsbyBlY3Mh
实例自定义数据。设置的自定义数据必须经过Base64编码，且Base64编码前的自定义数据大小不能超过16KB。
不填则默认为空。
Volumes.N.DeleteWithInstance boolean[] 可选 示例值：true
云盘是否随实例释放：
- 参数 - N：表示云盘的序号，序号为“1”表示系统盘；序号为“2”或大于“2”表示数据盘。取值：1 - 15。
- 参数 - DeleteWithInstance：云盘是否随实例释放。
- true：云盘随实例释放。
- false：云盘不随实例释放。
- 取值为false时对系统盘无效，系统盘默认随实例释放，不允许保留。
Volumes.N.Size integer[] 可选 示例值：100
云盘的容量，单位为GiB。
- 参数 - N：表示云盘的序号，序号为“1”表示系统盘；序号为“2”或大于“2”表示数据盘。取值：1 ～ 15。
- 取值 - Size：表述第N个云盘的容量，单位为GiB。
- 系统盘取值范围：10 - 500。
- 数据盘取值范围：10 - 8192。
- 多个云盘之间用&分隔。
Volumes.N.VolumeType string[] 可选 示例值：PTSSD
云盘的类型：
- 参数 - N：表示云盘的序号，序号为“1”表示系统盘，序号为“2”或大于“2”表示数据盘。取值：1 ～ 15。
- 参数 - VolumeType：表示第N个云盘的类型，取值：
- PTSSD：性能型SSD。
- ESSD_PL0：极速型SSD PL0。
- 多个云盘之间用&分隔。
Volumes.N.Encrypted boolean[] 可选 示例值：false
云盘是否加密：
- 参数 - N：表示云盘的序号，序号为“1”表示系统盘；序号为“2”或大于“2”表示数据盘。取值：1 - 15。
- 参数 - Encrypted：云盘是否加密。
- true：云盘加密。
- false：云盘不加密。
Volumes.N.KMSKeyId string[] 可选 示例值：key-
说明
当Volumes.N.Encrypted取值为true时必填。
ZoneId string 可选 示例值：cn-beijing-a
伸缩配置可用区ID。
返回参数
ScalingConfigurationId string 示例值：scc-ybmt16auaugh9zfy****
伸缩配置ID。
请求示例
返回示例
错误码
最近更新时间：2026.09.11 19:16:56
这个页面对您有帮助吗？
有用
有用
无用
无用