全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
弹性伸缩

创建伸缩配置

更新时间:2017-09-27 11:22:49

描述

根据传入参数创建伸缩配置。

  • 创建伸缩配置中指定的ECS实例规格(InstanceType)必须与伸缩组内生效的伸缩配置的实例规格一致。
  • 伸缩配置不可以编辑更改。如需使用新的伸缩配置,只能重新创建新的伸缩配置,并在伸缩组中激活(修改伸缩组的ActiveScalingConfigurationId属性)。
  • 在创建伸缩配置时,必须要选择镜像,用来确定新创建实例的系统盘配置。镜像包含操作系统以及应用软件配置,基于镜像创建实例后,实例的系统盘即为此镜像的完全克隆。
  • 创建一个实例时必须指定加入一个安全组,所以需要在伸缩配置里指定安全组。安全组需要预先创建。在同一个安全组内的实例内网可以相互访问,但不同安全组之间默认有防火墙隔离,不可相互访问,但可通过安全组授权(通过授权安全组权限接口实现)来设置此安全组的防火墙权限。同一个安全组内的实例数量不能超过1000个,若组内实例数量超出限制,创建实例时若指定该安全组,会提示失败。
  • 使用伸缩配置创建实例时,如果参数InternetChargeType的值设置为PayByBandwidth(按固定带宽付费),则InternetMaxBandwidthOut的设置值即为所选的固定带宽值;如果参数InternetChargeType的值设置为PayByTraffic(按流量付费),则InternetMaxBandwidthOut只是一个带宽的上限设置,计费以发生的网络流量为依据。设置InternetChargeType和InternetMaxBandwidthOut时,应仔细核算可能发生的带宽费用。
  • InternetMaxBandwidthIn的值在任何情况下都与计费无关,实例的入数据流量是免费的。
  • 实例创建时,系统会自己根据所指定的镜像为系统分配一个相应大小的系统盘。并且可以指定系统盘的种类:云磁盘、临时磁盘(如果您拥有开通临时磁盘的权限;新接入用户默认没有此权限)。
  • 单块云磁盘(cloud)容量最大不能超过2000G,单块临时磁盘(ephemeral)容量最大不能超过1T(1024G)。
  • 随实例创建的云磁盘(cloud),其Portable属性为False,即不能卸载和挂载。所有创建的磁盘的DeleteWithInstance的属性为True。
  • 一个实例最多添加4块数据盘。一个实例的临时磁盘总容量不超过2T(2048G)(不含系统盘)
  • 当系统盘是cloud时,数据盘不能是ephemeral;当系统盘是ephemeral时,数据盘既可以是ephemeral,也可以是cloud。
  • 使用伸缩配置实例创建时,ECS系统会自己根据所指定的镜像为系统分配一个相应大小的系统盘。
  • 实例内存为512M(含)以下时不能使用Windows操作系统;内存为4G(含)以上时不能使用32位操作系统。
  • 当伸缩组不指定VSwitchId,指定VPCId的安全组不可以用来创建伸缩配置。
  • 当伸缩组指定了VSwitchId,经典网络类型的安全组不可以用来创建伸缩配置,没有指定同一VPCId的安全组不可以用来创建伸缩配置。
  • 一个伸缩组内最多只能创建10个伸缩配置。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:CreateScalingConfiguration。
ScalingGroupId String 伸缩配置所属的伸缩组ID。
ImageId String 镜像文件ID,表示启动实例时选择的镜像资源。
InstanceType String ECS实例的资源规则。
SecurityGroupId String 指定新创建实例所属于的安全组ID,同一个安全组内的实例之间可以互相访问。
ScalingConfigurationName String 伸缩配置的显示名称,2-40 个英文或中文字符,以数字、大小写字母或中文开头,可包含数字,“_”、“-”或“.”。同一用户账号同一地域同一伸缩组内唯一。如果没有指定该参数,默认值为ScalingConfigurationId。
InternetChargeType String 网络计费类型,按流量计费或按固定带宽计费。可选值:
- PayByBandwidth:按带宽计费
- PayByTraffic:按流量计费
如用户不指定,默认是PayByBandwidth。
InternetMaxBandwidthIn Integer 公网入带宽最大值,单位为Mbps(Mega bit per second),取值范围:[1,200]。
如果客户不指定,AliyunAPI将自动将入带宽设置成200Mbps。
InternetMaxBandwidthOut Integer 公网出带宽最大值,单位为Mbps(Mega bit per second),取值范围:
- 按带宽计费:[1,100],如果客户不指定,API将自动将出带宽设置成0Mbps;
- 按流量计费:[1,100],如果客户不指定,会报错。
SystemDisk.Category String 系统盘的磁盘种类。可选值:cloud,ephemeral。
默认值:cloud
DataDisk.N.Size Integer 数据盘N的磁盘大小(N为1~4)。 以GB为单位,取值范围为:
- Cloud:5~2000
- Ephemeral:5~1024
最多可以输入4个。
DataDisk.N.Category String 数据盘N的磁盘种类(N为1~4)。
可选值:cloud ,ephemeral。默认值:cloud
最多可以输入4个。
DataDisk.N.SnapshotId String 创建数据盘使用的快照(N为1~4)。
指定该参数后DataDisk.N.Size会被忽略,实际创建的磁盘大小为指定快照的大小。若该快照创建于2013年7月15日(含)之前,该次调用会被拒绝,Response中返回InvalidSnapshot.TooOld最多可以输入4个。
DataDisk.N.Device String 数据盘挂载点(N为1~4)。
空白表示在自动创建ECS实例时由ECS系统默认分配,从/dev/xvdb开始到/dev/xvdz。 默认值:空白。
最多可以输入4个。

返回参数

名称 类型 描述
ScalingConfigurationId String 伸缩配置的ID,由系统生成,全局唯一。

错误码

对于所有接口的通用性错误,请参考客户端错误表服务器端错误表

错误 错误代码 描述 HTTP状态码
指定的伸缩组在该用户账号下不存在 InvalidScalingGroupId.NotFound The specified scaling group does not exist. 404
伸缩配置名已存在 InvalidScalingConfigurationName.Duplicate The specified value of parameter <parameter name> is duplicated. 400
用户的伸缩配置使用个数达到上限 QuotaExceeded.ScalingConfiguration Scaling configuration quota exceeded in the specified scaling group. 400
指定的镜像在该用户账号下不存在 InvalidImageId.NotFound The specified image does not exist. 404
指定的安全组在该用户账号下不存在 InvalidSecurityGroupId.NotFound The specified security group does not exist. 404
指定的实例规格不允许使用该指定的镜像 InvalidImageId.InstanceTypeMismatch The specified image does not support the specified instance type. 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
指定的安全组已添加的ECS实例个数达到上限 QuotaExceeded.SecurityGroupInstance Instance quota exceeded in the specified security group. 400
指定的伸缩配置的实例规格与当前的伸缩配置的实例规格不匹配 InstanceType.Mismatch The specified scaling configuration and existing active scaling configuration have different instance type. 400
临时磁盘数据盘总容量超过2T(2048G) QuotaExceeded.EphemeralDiskSize Ephemeral disk size quota exceeded. 403
指定的系统盘类型和数据盘类型冲突 InvalidParameter.Conflict The value of parameter <parameter name> and parameter <parameter name> are conflict. 400
没有创建临时磁盘系统盘的权限 InvalidSystemDiskCategory.ValueUnauthorized The system disk category is not authorized. 403
指定的快照不存在 InvalidDataDiskSnapshotId.NotFound Snapshot “XXX” does not exist. 404
指定的快照的大小超过了磁盘大小的限制 InvalidDataDiskSnapshotId.SizeNotSupported The capacity of snapshot “XXX” exceeds the size limit of the specified disk category. 400
该快照创建于2013年7月15日(含)之前,该次调用会被拒绝 InvalidSnapshot.TooOld This operation is denied because the specified snapshot is created before 2013-07-15. 403
数据盘挂载点重复 InvalidDevice.InUse Device “XXX” has been occupied. 403
指定了VSwitch的伸缩组不能再指定公网带宽和付费类型 InvalidParameter.Conflict The value of parameter InternetChargeType and parameter VSwitchId are conflict. 400

示例

请求示例
  1. http://ess.aliyuncs.com/?Action=CreateScalingConfiguration
  2. &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ2eaQ
  3. &SecurityGroupId=sg-280ih3w4b
  4. &ImageId=centos6u5_64_20G_aliaegis_20140703.vhd
  5. &InstanceType=ecs.t1.xsmall
  6. &<公共请求参数>
返回示例

XML格式:

  1. <CreateScalingConfigurationResponse>
  2. <ScalingConfigurationId>eOs27Kb0oXvQcUYjEGelJqUy</ScalingConfigurationId>
  3. <RequestId>5CC0AD41-08ED-4559-A683-6F56355FE068</RequestId>
  4. </CreateScalingConfigurationResponse>

JSON格式:

  1. {
  2. "RequestId": "5CC0AD41-08ED-4559-A683-6F56355FE068",
  3. "ScalingConfigurationId": "eOs27Kb0oXvQcUYjEGelJqUy",
  4. }
本文导读目录