弹性伸缩伸缩配置有哪些API?

调用CreateScalingConfiguration创建一个伸缩配置。

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

调试 请求参数 名称 类型 是否必选 示例值 描述 Action String 否 CreateScalingConfiguration 系统规定参数。取值： CreateScalingConfiguration。

ScalingGroupId String 是 asg-bp14wlu85wrpchm0**** 伸缩配置所属的伸缩组的ID。

ImageId String 否 centos6u5_64_20G_aliaegis****.vhd 镜像文件ID，自动创建实例时使用的镜像资源。

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

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

InstanceType String 否 ecs.t1.xsmall ECS实例的实例规格，更多信息请参见实例规格族。

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优化、可用区等因素确定可用实例规格集合，并根据价格排序为您创建价格最低的实例。

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。 DeploymentSetId String 否 ds-bp1frxuzdg87zh4pz**** ECS实例所属的部署集的ID。

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

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

SecurityGroupId String 否 sg-280ih**** ECS实例所属的安全组的ID，同一个安全组内的ECS实例可以互相访问。

IoOptimized String 否 optimized 是否为I/O优化实例。已停售的实例规格实例默认值是none，其他实例规格默认值是optimized。取值范围：

none：非I/O优化实例。 optimized：I/O优化实例。 InternetChargeType String 否 PayByTraffic 网络计费类型，取值范围：

PayByBandwidth：按带宽计费。此时InternetMaxBandwidthOut即为所选的固定带宽值。 PayByTraffic：按流量计费。此时InternetMaxBandwidthOut只是一个带宽上限，计费以实际产生的网络流量为依据。 如果未指定该参数，经典网络下默认值为PayByBandwidth，专有网络VPC下默认值为PayByTraffic。

InternetMaxBandwidthIn Integer 否 100 公网入带宽最大值，单位为Mbps (Mega bit per second)，取值范围：1~200。

如果您没有指定该参数，则入带宽将自动被设置为200Mbps。实例的入数据流量免费，该参数在任何情况下都不涉及计费。

InternetMaxBandwidthOut Integer 否 50 公网出带宽最大值，单位为Mbps (Mega bit per second)，取值范围：

按带宽计费：0~100，如果您没有指定该参数，则出带宽将自动被设置为0Mbps。 按流量计费：0~100，如果您没有指定该参数，则会出现报错。 SystemDisk.Category String 否 cloud_ssd 系统盘的磁盘种类。取值范围：

cloud：普通云盘 cloud_efficiency：高效云盘 cloud_ssd：SSD云盘 ephemeral_ssd：本地SSD盘 cloud_essd：ESSD云盘 InstanceType为系列I的实例规格且实例属于非I/O优化实例时，默认值：cloud。否则，默认值：cloud_efficiency。

SystemDisk.Size Integer 否 100 系统盘的大小，单位：GiB。取值范围：

cloud：20~500 cloud_efficiency：20~500 cloud_ssd：20~500 cloud_essd：20~500 ephemeral_ssd：20~500 默认值：max{40, ImageSize}。

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

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

默认值：空。

SystemDisk.Description String 否 FinanceDept 系统盘的描述。长度为2~256个英文或中文字符，不能以 http:// 和 https:// 开头。

SystemDisk.AutoSnapshotPolicyId String 否 sp-bp12m37ccmxvbmi5**** 系统盘使用的自动快照策略ID。

ScalingConfigurationName String 否 test-sc 伸缩配置的名称，2~64英文或中文字符，以数字、大小写字母或中文开头，可包含数字、下划线（_）、连字符（-）或点号（.）。

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

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-280s7**** 创建数据盘时使用的快照，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云盘 ephemeral_ssd：本地SSD盘 cloud_essd：ESSD云盘 对于I/O优化实例，默认值为cloud_efficiency。对于非I/O优化实例，默认值为cloud。

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

DataDisk.N.DeleteWithInstance Boolean 否 true 指定数据盘是否随实例释放，N的取值范围：1~16。该参数取值范围：

true：释放实例时，该磁盘随实例一起释放。 false：释放实例时，该磁盘保留不释放。 默认值：true。

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

DataDisk.N.Encrypted String 否 false 数据盘N是否加密，N的取值范围：1~16。该参数取值范围：

true：加密 false：不加密 默认值：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 否 FinanceDept 数据盘的描述，N的取值范围：1~16。长度为2~256个英文或中文字符，不能以 http:// 和 https:// 开头。

DataDisk.N.AutoSnapshotPolicyId String 否 sp-bp19nq9enxqkomib**** 数据盘使用的自动快照策略ID，N的取值范围：1~16。

LoadBalancerWeight Integer 否 50 后端服务器的权重，取值范围：1~100。

默认值：50。

Tags String 否 {"key1":"value1","key2":"value2", ... "key5":"value5"} ECS实例的标签。标签以键值对方式传入，最多可以使用5组标签。Key和Value的使用要求如下：

Key最多支持64个字符，不能以aliyun和acs:开头，不能包含 http:// 或者 https:// 。一旦使用标签，Key不允许为空字符串。 Value最多支持128个字符，不能以aliyun和acs:开头，不能包含 http:// 或者 https:// 。Value可以为空字符串。 UserData String 否 echo hello ecs! ECS实例的自定义数据，需要以Base64方式编码，编码前的原始数据最多为16KB。

KeyPairName String 否 KeyPairTest 登录ECS实例时使用的密钥对的名称。

对Windows实例，该参数将被忽略，默认为空。 对Linux实例，密码登录方式会被初始化成禁止。 RamRoleName String 否 RamRoleTest ECS实例的RAM角色名称。RAM角色名称由RAM提供和维护，您可调用ListRoles查询可用的RAM角色。创建RAM角色的方法请参见CreateRole。

SecurityEnhancementStrategy String 否 Active 是否开启安全加固。取值范围：

Active：启用安全加固，只对公共镜像生效。 Deactive：不启用安全加固，对所有镜像类型生效。 InstanceName String 否 Instance**** 使用本伸缩配置自动创建的ECS实例的名称。

HostName String 否 Host**** 云服务器的主机名。点号（.）或连字符（-）不能作为首尾字符，不能连续使用点号（.）或连字符（-）。另外，不同类型实例的命名要求如下：

Windows实例：主机名长度为2~15，可以包含大小写字母、数字和连字符（-）。不能包含点号（.），不能全是数字。 其他类型实例（Linux等）：主机名长度为2~64，可以包含多个点号（.）。两个点号（.）之间为一段，每段可以包含大小写字母、数字和连字符（-）。 SpotStrategy String 否 NoSpot 后付费实例的抢占策略。取值范围：

NoSpot：普通的按量付费实例。 SpotWithPriceLimit：设置上限价格的抢占式实例。 SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。 默认值：NoSpot。

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

SpotPriceLimit.N.InstanceType String 否 ecs.t1.xsmall 抢占式实例的实例规格，N的取值范围：1~10。SpotStrategy取值为SpotWithPriceLimit时生效。

SpotPriceLimit.N.PriceLimit Float 否 0.5 抢占式实例对应的出价，N的取值范围：1~10。SpotStrategy取值为SpotWithPriceLimit时生效。

Password String 否 123-abcABC ECS实例的密码。长度为8至30个字符，必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是：

()` ~!@#$%^&*-_+=|{}[]:;'<>,.?/ 其中，Windows实例不能以斜线号（/）为密码首字符。

说明 如果传入Password参数，建议您使用HTTPS协议发送请求，避免密码泄露。 ResourceGroupId String 否 rg-resource**** ECS实例所属资源组的ID。

SecurityGroupIds.N RepeatList 否 sg-bp18kz60mefs**** 将ECS实例同时加入多个安全组。N的取值范围与实例能够加入安全组上限有关。更多详情，请参见使用限制下的安全组章节。

说明 不支持同时指定SecurityGroupId和SecurityGroupIds.N。 HpcClusterId String 否 hpc-clusterid ECS实例所属的EHPC集群的ID。

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

ClientToken String 否 123e4567-e89b-12d3-a456-42665544**** 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持ASCII字符，且不能超过64个字符。更多详情，请参见如何保证幂等性。

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

返回数据 名称 类型 示例值 描述 ScalingConfigurationId String asc-bp1ffogfdauy0nu5**** 伸缩配置ID。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。

示例 请求示例

http(s)://[Endpoint]/?Action=CreateScalingConfiguration &ScalingGroupId=asg-bp14wlu85wrpchm0**** &SecurityGroupId=sg-280ih**** &<公共请求参数> 正常返回示例

XML 格式

asc-bp1ffogfdauy0nu5**** 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E JSON 格式

{ "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E", "ScalingConfigurationId": "asc-bp1ffogfdauy0nu5****" } 错误码 访问错误中心查看更多错误码。

HttpCode

错误码

错误信息

描述

400

InstanceType.Mismatch

The specified scaling configuration and existing active scaling configuration have different instance type.

指定的伸缩配置的实例规格与当前的伸缩配置的实例规格不匹配。

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.

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

403

InvalidDevice.InUse

Device “XXX” has been occupied.

数据盘挂载点重复。

400

InvalidImageId.InstanceTypeMismatch

The specified image does not support the specified instance type.

不允许在指定的实例规格下使用该镜像。

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

InvalidParameter

The specified value of parameter KeyPairName is not valid.

Windows系统不支持KeyPairName参数。

400

InvalidParameter.Conflict

The value of parameter SystemDisk.Category and parameter DataDisk.N.Category are conflict.

指定的系统盘类型和数据盘类型冲突。

400

InvalidRamRole.NotFound

The specified RamRoleName does not exist.

不存在指定的RamRoleName。

400

InvalidScalingConfigurationName.Duplicate

The specified value of parameter ScalingConfigurationName is duplicated.

已存在相同伸缩配置名。

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

该账号下不存在指定的伸缩组。

400

InvalidSecurityGroupId.IncorrectNetworkType

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

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

404

InvalidSecurityGroupId.NotFound

The specified security group does not exist.

该账号下不存在指定的安全组。

400

InvalidSecurityGroupId.VPCMismatch

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

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

403

InvalidSnapshot.TooOld

This operation is denied because the specified snapshot is created before 2013-07-15.

该快照创建于2013年7月15日或之前，调用被拒绝。

403

InvalidSystemDiskCategory.ValueUnauthorized

The system disk category is not authorized.

没有创建临时磁盘系统盘的权限。

400

InvalidUserData.Base64FormatInvalid

The specified parameter UserData must be base64 encoded.

UserData不符合Base64编码规范。

400

InvalidUserData.SizeExceeded

The specified parameter UserData exceeds the size.

指定的UserData过长。

403

QuotaExceeded.EphemeralDiskSize

Ephemeral disk size quota exceeded.

临时磁盘数据盘总容量超过2TiB（2048GiB）。

400

QuotaExceeded.ScalingConfiguration

Scaling configuration quota exceeded in the specified scaling group.

您目前拥有的伸缩配置个数已经达到上限。

400

QuotaExceeded.SecurityGroupInstance

Instance quota exceeded in the specified security group.

指定的安全组中添加的ECS实例个数已经达到上限。

调用DescribeScalingConfigurations查询现有的伸缩配置。

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

调试 请求参数 名称 类型 是否必选 示例值 描述 Action String 否 DescribeScalingConfigurations 系统规定参数，取值：DescribeScalingConfigurations。

RegionId String 是 cn-qingdao 伸缩配置所属伸缩组的地域ID。

PageNumber Integer 否 1 伸缩配置列表的页码。起始值：1。

默认值：1 。

PageSize Integer 否 50 分页查询时设置的每页行数。最大值：50。

默认值：10。

ScalingGroupId String 否 asg-bp17pelvl720x3v7**** 伸缩组的ID，您可以查询该伸缩组下所有的伸缩配置。

ScalingConfigurationId.1 String 否 asc-bp17pelvl720x5ub**** ScalingConfigurationId.N为待查询伸缩配置的ID，N的取值范围：1～10。查询结果包括生效和失效的伸缩配置，并通过返回参数LifecycleState进行标识。

ScalingConfigurationName.1 String 否 c1908dd1-690f-4c9b-ab73-350f1f06**** ScalingConfigurationName.N为待查询伸缩配置的名称，N的取值范围：1～10。查询结果会忽略失效的伸缩配置名称，并且不报错。

返回数据 名称 类型 示例值 描述 TotalCount Integer 1 伸缩配置的总数。

PageNumber Integer 1 当前页码。

PageSize Integer 50 每页行数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。

ScalingConfigurations Array 伸缩配置信息的集合。

示例 请求示例

http(s)://[Endpoint]/?Action=DescribeScalingConfigurations &RegionId=cn-qingdao &<公共请求参数> 正常返回示例

XML 格式

804F240A-8D3E-40A1-BD68-6B333DEA2CA8 1 1 50 2014-08-14T10:58Z centos6u5_64_20G_aliaegis_20140703.vhd ecs.t1.xsmall PayByTraffic 200 0 Active asc-bp1ezrfgoyn5kijl**** c1908dd1-690f-4c9b-ab73-350f1f06**** sg-280ih**** sg-bp18kz60mefs**** cloud 200 cloud s-280s7**** /dev/xvdb JSON 格式

{ "RequestId": "804F240A-8D3E-40A1-BD68-6B333DEA2CA8", "TotalCount": "1", "PageNumber": "1", "PageSize": "50", "ScalingConfigurations": { "ScalingConfiguration": { "CreationTime": "2014-08-14T10:58Z", "ImageId": "centos6u5_64_20G_aliaegis_20140703.vhd", "InstanceType": "ecs.t1.xsmall", "InternetChargeType": "PayByTraffic", "InternetMaxBandwidthIn": "200", "InternetMaxBandwidthOut": "0", "LifecycleState": "Active", "ScalingConfigurationId": "asc-bp1ezrfgoyn5kijl****", "ScalingConfigurationName": "c1908dd1-690f-4c9b-ab73-350f1f06****", "ScalingGroupId": "sg-280ih****", "SecurityGroupId": "sg-bp18kz60mefs****", "SystemDiskCategory": "cloud", "DataDisks": { "DataDisk": { "Size": "200", "Category": "cloud", "SnapshotId": "s-280s7****", "Device": "/dev/xvdb" } } } } } 错误码 访问错误中心查看更多错误码。调用DeleteScalingConfiguration删除一个伸缩配置。

接口说明 以下情况不能删除伸缩配置：

伸缩配置在伸缩组中处于生效状态。 伸缩组中仍然存在使用该伸缩配置创建的ECS实例。 调试 您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试 请求参数 名称 类型 是否必选 示例值 描述 ScalingConfigurationId String 是 eOs27Kb0oXvQcUYjEGel**** 待删除伸缩配置的ID。

Action String 否 DeleteScalingConfiguration 系统规定参数，取值：DeleteScalingConfiguration。

返回数据 名称 类型 示例值 描述 RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求 ID。无论调用接口成功与否，我们都会返回请求 ID。

示例 请求示例

http://ess.aliyuncs.com/?Action=DeleteScalingConfiguration &ScalingConfigurationId=eOs27Kb0oXvQcUYjEGel**** &<公共请求参数> 正常返回示例

XML 格式

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E JSON 格式

{ "RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E" } 错误码 访问错误中心查看更多错误码。

HttpCode

错误码

错误信息

描述

404

InvalidScalingConfigurationId.NotFound

The specified scaling configuration does not exist.

指定的伸缩配置在该用户账号下不存在。

400

IncorrectScalingConfigurationLifecycleState

The current lifecycle state of specified scaling configuration does not support this action.

指定的伸缩配置未处于Inactive状态。

400

InstanceInUse

You cannot delete a scaling configuration or scaling group while there is an instance associated with it.

指定的伸缩配置还有关联的ECS实例未被删除。调用ModifyScalingConfiguration修改一个伸缩配置。

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

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

调试 请求参数 名称 类型 是否必选 示例值 描述 ScalingConfigurationId String 是 asc-**** 待修改伸缩配置的ID。

Action String 否 ModifyScalingConfiguration 系统规定参数，取值： ModifyScalingConfiguration。

Cpu Integer 否 2 vCPU个数。

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

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。 DataDisk.N.AutoSnapshotPolicyId String 否 sp-bp19nq9enxqkomib**** 数据盘使用的自动快照策略ID，N的取值范围：1~16。

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.DeleteWithInstance Boolean 否 true 指定数据盘是否随实例释放，N的取值范围：1~16。该参数取值范围：

true：释放实例时，该磁盘随实例一起释放。 false：释放实例时，该磁盘保留不释放。 该参数只可对独立云盘设置（DataDisk.N.Category为cloud、cloud_efficiency、cloud_ssd或cloud_essd），否则会出现报错。

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

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

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

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.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。

DeploymentSetId String 否 ds-bp13v7bjnj9gis**** ECS实例所属的部署集的ID。

HostName String 否 Joshu**** 云服务器的主机名。点号（.）或连字符（-）不能作为首尾字符，不能连续使用点号（.）或连字符（-）。另外，不同类型实例的命名要求如下：

Windows实例：主机名长度为2~15，可以包含大小写字母、数字和连字符（-）。不能包含点号（.），不能全是数字。 其他类型实例（Linux等）：主机名长度为2~64，可以包含多个点号（.）。两个点号（.）之间为一段，每段可以包含大小写字母、数字和连字符（-）。 HpcClusterId String 否 hpc-clusterid ECS实例所属的EHPC集群的ID。

ImageId String 否 centos6u5_64_20G_aliaegis_20140703.vhd 镜像文件ID，自动创建实例时使用的镜像资源。

ImageName String 否 suse11sp3_64_20G_aliaegis_20150428.vhd 镜像文件名称，同一个地域内镜像名称唯一。如果设置了ImageId， ImageName将被忽略。

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

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

InstanceName String 否 Joshu**** 使用本伸缩配置自动创建的ECS实例的名称。

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

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

InternetChargeType String 否 PayByBandwidth 网络计费类型，取值范围：

PayByBandwidth：按带宽计费。此时InternetMaxBandwidthOut即为所选的固定带宽值。 PayByTraffic：按流量计费。此时InternetMaxBandwidthOut只是一个带宽上限，计费以实际产生的网络流量为依据。 InternetMaxBandwidthOut Integer 否 50 公网出带宽最大值，单位为Mbps (Mega bit per second)，取值范围：

按带宽计费：0~100，如果您没有指定该参数，则出带宽将自动被设置为0Mbps。 按流量计费：0~100，如果您没有指定该参数，则会出现报错。 IoOptimized String 否 none 是否为I/O优化实例。取值范围：

none：非I/O优化实例。 optimized：I/O优化实例。 KeyPairName String 否 null 登录ECS实例时使用的密钥对的名称。

对Windows实例，该参数将被忽略，默认为空。 对Linux实例，密码登录方式会被初始化成禁止。 LoadBalancerWeight Integer 否 50 后端服务器的权重，取值范围：0~100。

Memory Integer 否 16 内存大小。

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

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。 Override Boolean 否 true 是否覆盖。取值范围：

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

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

ResourceGroupId String 否 abcd1234abcd**** ECS实例所属资源组的ID。

ScalingConfigurationName String 否 test-modify 伸缩配置的名称，2~64个英文或中文字符，以数字、大小写字母或中文开头，可包含数字、下划线（_）、连字符（-）或点号（.）。

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

SecurityGroupId String 否 sg-F876F**** ECS实例所属的安全组的ID，同一个安全组内的ECS实例可以互相访问。

SecurityGroupIds.N RepeatList 否 sg-bp18kz60mefs**** 将ECS实例同时加入多个安全组。N的取值范围与实例能够加入安全组上限有关。更多详情，请参见使用限制下的安全组章节。

说明 不支持同时指定SecurityGroupId和SecurityGroupIds.N。 SpotPriceLimit.N.InstanceType String 否 ecs.t1.small 抢占式实例的实例规格，N的取值范围：1~10。SpotStrategy取值为SpotWithPriceLimit时生效。

SpotPriceLimit.N.PriceLimit Float 否 0.125 抢占式实例对应的出价，N的取值范围：1~10。SpotStrategy取值为SpotWithPriceLimit时生效。

SpotStrategy String 否 NoSpot 后付费实例的抢占策略。取值范围：

NoSpot：普通的按量付费实例。 SpotWithPriceLimit：设置上限价格的抢占式实例。 SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。 SystemDisk.AutoSnapshotPolicyId String 否 sp-bp12m37ccmxvbmi5**** 系统盘使用的自动快照策略ID。

SystemDisk.Category String 否 cloud_efficiency 系统盘的磁盘种类。取值范围：

cloud：普通云盘 cloud_efficiency：高效云盘 cloud_ssd：SSD云盘 cloud_essd：ESSD云盘 ephemeral_ssd：本地SSD盘 SystemDisk.Description String 否 FinanceDept 系统盘的描述。长度为2~256个英文或中文字符，不能以 http:// 和 https:// 开头。

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

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}。

Tags String 否 “key1”:”value1” ECS实例的标签。标签以键值对方式传入，最多可以使用5组标签。Key和Value的使用要求如下：

Key最多支持64个字符，不能以aliyun和acs:开头，不能包含 http:// 或者 https:// 。一旦使用标签，Key不允许为空字符串。 Value最多支持128个字符，不能以aliyun和acs:开头，不能包含 http:// 或者 https:// 。Value可以为空字符串。 UserData String 否 echo hello ecs! ECS实例的自定义数据，需要以Base64方式编码，编码前的原始数据最多为16KB。

返回数据 名称 类型 示例值 描述 RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。

示例 请求示例

http(s)://[Endpoint]/?Action=ModifyScalingConfiguration &ScalingConfigurationId=asc-**** &<公共请求参数> 正常返回示例

XML 格式

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 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 “5”.

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过长。