调用ModifyScalingConfiguration修改一个伸缩配置。

接口说明

如果修改伸缩配置的名称,请注意同一伸缩组下不能存在名称相同的伸缩配置。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyScalingConfiguration

系统规定参数。取值: ModifyScalingConfiguration

ScalingConfigurationId String asc-bp16har3jpj6fjbx****

待修改伸缩配置的ID。

IoOptimized String none

是否为I/O优化实例。取值范围:

  • none:非I/O优化实例。
  • optimized:I/O优化实例。
DataDisk.N.Size Integer 100

数据盘N的磁盘大小,N的取值范围:1~16,内存单位为GiB。取值范围:

  • cloud:5~2000
  • cloud_efficiency:20~32768
  • cloud_ssd:20~32768
  • cloud_essd:20~32768
  • ephemeral_ssd:5~800

指定该参数后,磁盘大小必须大于等于快照大小(快照通过SnapshotId指定)。

DataDisk.N.SnapshotId String s-snapshot****

创建数据盘时使用的快照,N的取值范围:1~16。指定该参数后,DataDisk.N.Size会被忽略,实际创建的磁盘大小为指定快照的大小。

如果该快照创建于2013年7月15日或之前,调用会被拒绝,返回参数中会提示InvalidSnapshot.TooOld。

DataDisk.N.Category String cloud_ssd

数据盘N的磁盘种类,N的取值范围:1~16。该参数取值范围:

  • cloud:普通云盘。随实例创建的普通云盘的DeleteWithInstance属性为true。
  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD云盘。
  • cloud_essd:ESSD云盘。
  • ephemeral_ssd:本地SSD盘。
DataDisk.N.Device String /dev/xvdb

数据盘挂载点,N的取值范围:1~16。如果您没有指定该参数,则默认在自动创建ECS实例时由系统分配,从/dev/xvdb开始,到/dev/xvdz结束。

DataDisk.N.DeleteWithInstance Boolean true

指定数据盘是否随实例释放,N的取值范围:1~16。该参数取值范围:

  • true:释放实例时,该磁盘随实例一起释放。
  • false:释放实例时,该磁盘保留不释放。

该参数只可对独立云盘设置(DataDisk.N.Category为cloud、cloud_efficiency、cloud_ssd或cloud_essd),否则会出现报错。

DataDisk.N.Encrypted String false

数据盘N是否加密,N的取值范围:1~16。该参数取值范围:

  • true:加密。
  • false:不加密。
DataDisk.N.KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40****

数据盘对应的KMS密钥的ID,N的取值范围:1~16。

DataDisk.N.DiskName String cloud_ssdData

数据盘的名称,N的取值范围:1~16。长度为2~128个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

DataDisk.N.Description String Test data disk.

数据盘的描述,N的取值范围:1~16。长度为2~256个英文或中文字符,不能以 http:// 和 https:// 开头。

DataDisk.N.AutoSnapshotPolicyId String sp-bp19nq9enxqkomib****

数据盘使用的自动快照策略ID,N的取值范围:1~16。

DataDisk.N.PerformanceLevel String PL1

当数据盘为ESSD云盘时,设置云盘的性能等级。N的取值必须和DataDisk.N.Category=cloud_essd中的N保持一致。取值范围:

  • PL0:单盘最高随机读写IOPS 1万。
  • PL1:单盘最高随机读写IOPS 5万。
  • PL2:单盘最高随机读写IOPS 10万。
  • PL3:单盘最高随机读写IOPS 100万。

默认值:PL1

说明 关于如何选择ESSD云盘性能等级,请参见ESSD云盘
SpotStrategy String NoSpot

后付费实例的抢占策略。取值范围:

  • NoSpot:普通的按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。
SpotPriceLimit.N.InstanceType String ecs.g6.large

抢占式实例的实例规格,N的取值范围:1~10。SpotStrategy取值为SpotWithPriceLimit时生效。

SpotPriceLimit.N.PriceLimit Float 0.125

抢占式实例对应的出价,N的取值范围:1~10。SpotStrategy取值为SpotWithPriceLimit时生效。

ScalingConfigurationName String test-modify

伸缩配置的名称,2~64个英文或中文字符,以数字、大小写字母或中文开头,可包含数字、下划线(_)、连字符(-)或点号(.)。

在同一地域下同一伸缩组内伸缩配置名称唯一。如果您没有指定该参数,则默认使用伸缩配置的ID。

InstanceName String inst****

使用本伸缩配置自动创建的ECS实例的名称。

HostName String hos****

云服务器的主机名。点号(.)或连字符(-)不能作为首尾字符,不能连续使用点号(.)或连字符(-)。另外,不同类型实例的命名要求如下:

  • Windows实例:主机名长度为2~15,可以包含大小写字母、数字和连字符(-)。不能包含点号(.),不能全是数字。
  • 其他类型实例(Linux等):主机名长度为2~64,可以包含多个点号(.)。两个点号(.)之间为一段,每段可以包含大小写字母、数字和连字符(-)。
ImageId String centos6u5_64_20G_aliaegis_2014****.vhd

镜像文件ID,自动创建实例时使用的镜像资源。

说明 如果伸缩配置之前使用的镜像包括系统盘和数据盘,修改此镜像后,原数据盘信息会被清除。
ImageName String suse11sp3_64_20G_aliaegis_20150428.vhd

镜像文件名称,同一个地域内镜像名称唯一。如果设置了ImageId, ImageName将被忽略。

不支持通过ImageName设置镜像市场镜像。

InstanceTypes.N RepeatList ecs.g6.large

多实例规格参数。如果使用了InstanceTypes.N,InstanceType将被忽略,其中N的取值范围:1~10,即一个伸缩配置内最多可以设置10种实例规格。

N代表当前伸缩配置中实例规格的优先级,编号为1的实例规格优先级最高,实例规格优先级随着编号的增大依次降低。当无法根据优先级较高的实例规格创建出实例时,弹性伸缩服务会自动选择下一优先级的实例规格来创建实例。

InstanceTypeOverride.N.InstanceType String ecs.c5.xlarge

当您需要指定伸缩配置中实例规格的容量时,请同时指定本参数和InstanceTypeOverride.N.WeightedCapacity。

本参数用于指定实例规格。您可以指定N个本参数,结合InstanceTypeOverride.N.WeightedCapacity参数,扩展多实例规格支持自定义权重。N的取值范围:1~10。

说明 指定本参数时,不允许同时指定instanceTypes。

InstanceType的取值范围:在售的ECS实例规格,请参见实例规格族

InstanceTypeOverride.N.WeightedCapacity Integer 4

当您需要指定伸缩配置中实例规格的容量时,在指定InstanceTypeOverride.N.InstanceType后,再指定本参数。两个参数一一对应,N需要保持一致。

本参数用于指定实例规格的权重,即实例规格的单台实例在伸缩组中表示的容量大小。权重越大,满足期望容量所需的本实例规格的实例数量越少。

由于每个实例规格的vCPU个数、内存大小等性能指标会有差异,您可以根据自身需求,给不同的实例规格配置不同的权重。

例如:

  • 当前容量:0
  • 期望容量:6
  • ecs.c5.xlarge规格容量:4

为满足期望容量,伸缩组将为用户扩容2台ecs.c5.xlarge实例。

说明 扩容时伸缩组的容量不得超过最大容量(MaxSize)与实例规格的最大权重之和。

WeightedCapacity的取值范围:1~500。

Cpu Integer 2

vCPU个数。

同时指定CPU和Memory可以定义实例规格范围,例如,CPU=2且Memory=16可以定义配置为2 vCPU和16 GiB的所有实例规格。弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。
Memory Integer 16

内存大小。

同时指定CPU和Memory可以定义实例规格范围,例如,CPU=2且Memory=16可以定义配置为2 vCPU和16 GiB的所有实例规格。弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。
InternetChargeType String PayByBandwidth

网络计费类型。取值范围:

  • PayByBandwidth:按带宽计费。此时InternetMaxBandwidthOut即为所选的固定带宽值。
  • PayByTraffic:按流量计费。此时InternetMaxBandwidthOut只是一个带宽上限,计费以实际产生的网络流量为依据。
InternetMaxBandwidthOut Integer 50

公网出带宽最大值,单位为Mbps(Mega bit per second)。取值范围:

  • 按带宽计费:0~100,如果您没有指定该参数,则出带宽将自动被设置为0Mbps。
  • 按流量计费:0~100,如果您没有指定该参数,则会出现报错。
SystemDisk.Category String cloud_efficiency

系统盘的磁盘种类。取值范围:

  • cloud:普通云盘。
  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD云盘。
  • cloud_essd:ESSD云盘。
  • ephemeral_ssd:本地SSD盘。
SystemDisk.Size Integer 50

系统盘的大小,单位:GiB。取值范围:

  • cloud:20~500
  • cloud_efficiency:20~500
  • cloud_ssd:20~500
  • cloud_essd:20~500
  • ephemeral_ssd:20~500

指定该参数后,系统盘大小必须大于等于max{20, ImageSize}。

SystemDisk.DiskName String cloud_ssdSystem

系统盘的名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

SystemDisk.Description String Test system disk.

系统盘的描述。长度为2~256个英文或中文字符,不能以 http:// 和 https:// 开头。

SystemDisk.AutoSnapshotPolicyId String sp-bp12m37ccmxvbmi5****

系统盘使用的自动快照策略ID。

SystemDisk.PerformanceLevel String PL0

当系统盘为ESSD云盘时,设置云盘的性能等级。取值范围:

  • PL0:单盘最高随机读写IOPS 1万。
  • PL1:单盘最高随机读写IOPS 5万。
  • PL2:单盘最高随机读写IOPS 10万。
  • PL3:单盘最高随机读写IOPS 100万。

默认值:PL0

说明 关于如何选择ESSD云盘性能等级,请参见ESSD云盘
LoadBalancerWeight Integer 50

后端服务器的权重,取值范围:1~100。

UserData String echo hello ecs!

ECS实例的自定义数据,需要以Base64方式编码,编码前的原始数据最多为16KB。

KeyPairName String KeyPair_Name

登录ECS实例时使用的密钥对的名称。

  • 对Windows实例,该参数将被忽略,默认为空。
  • 对Linux实例,密码登录方式会被初始化成禁止。
RamRoleName String RamRoleTest

ECS实例的RAM角色名称。RAM角色名称由RAM提供和维护,您可调用ListRoles查询可用的RAM角色。创建RAM角色的方法请参见CreateRole

PasswordInherit Boolean false

是否使用镜像预设的密码。使用该参数时,您需要确保使用的镜像已经设置了密码。

Tags String “key1”:”value1”

ECS实例的标签。标签以键值对方式传入,最多可以使用20组标签。Key和Value的使用要求如下:

  • Key最多支持64个字符,不能以aliyun和acs:开头,不能包含 http:// 或者 https:// 。一旦使用标签,Key不允许为空字符串。
  • Value最多支持128个字符,不能以aliyun和acs:开头,不能包含 http:// 或者 https:// 。Value可以为空字符串。
DeploymentSetId String ds-bp13v7bjnj9gis****

ECS实例所属的部署集的ID。

SecurityGroupId String sg-F876F****

ECS实例所属的安全组的ID,同一个安全组内的ECS实例可以互相访问。

Override Boolean true

是否覆盖。取值范围:

  • true:覆盖。
  • false:不覆盖。
ResourceGroupId String abcd1234abcd****

ECS实例所属资源组的ID。

SecurityGroupIds.N RepeatList sg-bp18kz60mefs****

将ECS实例同时加入多个安全组。N的取值范围与实例能够加入安全组上限有关。更多详情,请参见使用限制下的安全组章节。

说明 不支持同时指定SecurityGroupId和SecurityGroupIds.N。
HpcClusterId String hpc-clusterid

ECS实例所属的HPC集群的ID。

InstanceDescription String Test instance.

ECS实例的描述。长度为2~256个英文或中文字符,不能以 http:// 和 https:// 开头。

Ipv6AddressCount Integer 1

为弹性网卡指定随机生成的IPv6地址数量。

CreditSpecification String Standard

修改突发性能实例的运行模式。取值范围:

ImageFamily String hangzhou-daily-update

镜像族系名称,通过设置该参数来获取当前镜像族系内最新可用的自定义镜像,用于创建实例。如果已经设置了参数ImageId,则不能设置该参数。

ZoneId String cn-hangzhou-g

ECS实例所属的可用区ID。

DedicatedHostId String dh-bp67acfmxazb4p****

是否在专有宿主机上创建ECS实例。由于专有宿主机不支持创建抢占式实例,指定DedicatedHostId参数后,会自动忽略请求中的SpotStrategy和SpotPriceLimit设置。

您可以通过DescribeDedicatedHosts查询专有宿主机ID列表。

Affinity String default

专有宿主机实例是否与专有宿主机关联。取值范围:

  • default:实例不与专有宿主机关联。已开启停机不收费功能的实例,停机后再次启动时,若原专有宿主机可用资源不足,则实例被放置在自动部署资源池的其它专有宿主机上。
  • host:实例与专有宿主机关联。已开启停机不收费功能的实例,停机后再次启动时,仍放置在原专有宿主机上。若原专有宿主机可用资源不足,则实例重启失败。
Tenancy String default

是否在专有宿主机上创建实例。取值范围:

  • default:创建非专有宿主机实例。
  • host:创建专有宿主机实例。若您不指定DedicatedHostId,则由阿里云自动选择专有宿主机放置实例。
PrivatePoolOptions.MatchCriteria String Open

实例启动的私有池容量选项。弹性保障服务或容量预定服务在生效后会生成私有池容量,供实例启动时选择。取值范围:

  • Open:开放模式。将自动匹配开放类型的私有池容量。如果没有符合条件的私有池容量,则使用公共池资源启动。该模式下无需设置PrivatePoolOptions.Id参数。
  • Target:指定模式。使用指定的私有池容量启动实例,如果该私有池容量不可用,则实例会启动失败。该模式下必须指定私有池ID,即PrivatePoolOptions.Id参数为必填项。
  • None:不使用模式。实例启动将不使用私有池容量。
说明 该参数邀测中,详情请提交工单咨询。
PrivatePoolOptions.Id String eap-bp67acfmxazb4****

私有池ID。即弹性保障服务ID或容量预定服务ID。

说明 该参数邀测中,详情请提交工单咨询。
SpotDuration Integer 1

抢占式实例的保留时长,单位为小时。取值范围:0~6。

  • 保留时长2~6正在邀测中,如需开通请提交工单。
  • 保留时长为0,则为无保护期模式。

默认值:1

SpotInterruptionBehavior String Terminate

抢占实例中断模式。目前仅支持Terminate(默认)直接释放实例。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ess.aliyuncs.com/?Action=ModifyScalingConfiguration
&ScalingConfigurationId=asc-bp16har3jpj6fjbx****
&InstanceName=instan****
&<公共请求参数>

正常返回示例

XML格式

<ModifyScalingConfigurationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyScalingConfigurationResponse>

JSON格式

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

访问错误中心查看更多错误码。

HttpCode

错误码

错误信息

描述

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

未授权操作当前Action。

404

InvalidDataDiskSnapshotId.NotFound

Snapshot “XXX” does not exist.

不存在指定的快照。

400

InvalidDataDiskSnapshotId.SizeNotSupported

The capacity of snapshot “XXX” exceeds the size limit of the specified disk category.

指定快照的大小超过了磁盘大小的限制。

404

InvalidImageId.NotFound

The specified image does not exist.

指定的镜像不存在。

400

InvalidKeyPairName.NotFound

The specified KeyPairName does not exist in our records.

指定的KeyPairName不存在。

400

InvalidNetworkType.ForRAMRole

RAMRole can’t be used For classic instance.

经典网络实例不支持RamRoleName参数。

400

InvalidParamter

The specified value of parameter is not valid.

指定的参数值无效。

400

InvalidScalingConfigurationName.Duplicate

The specified value of parameter is duplicated.

伸缩配置名已存在。

400

InvalidSecurityGroupId.IncorrectNetworkType

The network type of specified Security Group does not support this action.

指定的安全组与伸缩组指定网络类型不一致。

400

InvalidSecurityGroupId.VPCMismatch

The specified security group and the specified virtual switch are not in the same VPC.

指定的安全组和虚拟交换机不属于同一个虚拟专有网络。

400

InvalidTags.KeyValue

The specified tags key/value cannot be empty.

必须指定Tags参数。

400

InvalidTags.ListSize

The specified tags list size cannot be more than “20”.

Tags列表长度超过限制长度。

400

InvalidUserData.Base64FormatInvalid

The specified parameter UserData must be base64 encoded.

UserData不符合Base64编码规范。

400

InvalidUserData.SizeExceeded

The specified parameter UserData exceeds the size.

指定的UserData过长。