通过调用CreateScalingConfiguration接口,并指定伸缩组ID、实例规格、实例镜像等信息,为伸缩组创建一个ECS类型的伸缩配置。
接口说明
伸缩配置用来指定弹性扩张时使用的ECS实例模板,支持以下实例配置方式:
- InstancePatternInfo.N:智能配置模式,无需指定具体的实例规格,只需根据业务需求指定实例的vCPU核数、内存大小、规格族级别以及最高价格,系统会自动筛选符合要求的实例规格,并优先选择价格最低的实例规格创建ECS实例。该模式仅适用于伸缩组的网络类型为专有网络,能够有效降低扩容时实例规格库存不足的情况。
- InstanceType:指定一种实例规格。
- InstanceTypes.N:指定多种实例规格。
- InstanceTypeOverride.N:指定多种实例规格,并为不同的实例规格配置权重。
- Cpu和Memory:指定CPU和内存定义实例规格的范围,弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。该方式仅适用于伸缩组的扩缩容策略为成本优化策略,且伸缩配置未指定实例规格的场景。
- 支持以下任一方式绑定主网卡。但需要注意每次调用接口时只能选用一种方式配置主网卡,两种方式同时使用时将会导致接口调用失败并返回错误信息。
- 通过
SecurityGroupId
、SecurityGroupIds.N
与Ipv6AddressCount
等参数直接设置主网卡的相关配置信息。 - 通过
NetworkInterfaces.N
设置主网卡以及辅助网卡的配置信息,使用该参数时必须设置主网卡信息。其中,NetworkInterfaces.N.InstanceType
取值为Primary
时,表示设置主网卡;当NetworkInterfaces.N.InstanceType
取值为Secondary
或空值时,表示设置辅助网卡。
- 通过
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | CreateScalingConfiguration | 系统规定参数。取值:CreateScalingConfiguration。 |
ScalingGroupId | String | 是 | asg-bp14wlu85wrpchm0**** | 伸缩配置所属的伸缩组的ID。 |
ImageId | String | 否 | centos6u5_64_20G_aliaegis****.vhd | 镜像文件ID,自动创建实例时使用的镜像资源。 说明 该参数与 ImageName 参数作用相同,您可以根据实际情况进行二选一设置,即如果设置了ImageName参数,则ImageId参数将被忽略(非必填项)。 |
ImageName | String | 否 | image**** | 镜像文件名称,同一个地域内镜像名称唯一。不支持通过该参数设置镜像市场中的镜像。 说明 该参数与 ImageId 参数作用相同,您可以根据实际情况进行二选一设置,即如果设置了ImageId 参数,则ImageName 参数将被忽略(非必填项)。 |
InstanceType | String | 否 | ecs.g6.large | ECS实例的一种实例规格,更多信息,请参见实例规格族。 说明 InstanceType、InstanceTypes、InstanceTypeOverrides、Cpu和Memory 这四种方式不能同时指定,但InstanceType可以与InstancePatternInfo同时指定,此时,弹性伸缩会优先使用您指定的实例规格扩容,当指定的实例规格无库存时,再使用符合InstancePatternInfo 配置的实例规格。 |
Cpu | Integer | 否 | 2 | vCPU个数。单位:核。 同时指定CPU和Memory可以定义实例规格范围,例如,CPU=2且Memory=16可以定义配置为2 vCPU和16 GiB的所有实例规格。弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。 说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。 |
Memory | Integer | 否 | 16 | 内存大小。单位:GiB。 同时指定CPU和Memory可以定义实例规格范围。例如,CPU=2且Memory=16可以定义配置为2 vCPU和16 GiB的所有实例规格。弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。 说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。 |
DeploymentSetId | String | 否 | ds-bp1frxuzdg87zh4pz**** | ECS实例所属的部署集的ID。 |
SecurityGroupId | String | 否 | sg-280ih**** | ECS实例所属的安全组的ID,同一个安全组内的ECS实例可以互相访问。 |
IoOptimized | String | 否 | optimized | 是否为I/O优化实例。取值范围:
已停售的实例规格的实例默认值是none,其他实例规格的实例默认值是optimized。 |
InternetChargeType | String | 否 | PayByTraffic | 网络计费类型。取值范围:
如果未指定该参数,经典网络下默认值为PayByBandwidth,专有网络VPC下默认值为PayByTraffic。 |
InternetMaxBandwidthIn | Integer | 否 | 100 | 公网入带宽最大值,单位为Mbps(Mega bit per second),取值范围:1~200。 如果您没有指定该参数,则入带宽将自动被设置为200 Mbps。实例的入数据流量免费,该参数在任何情况下都不涉及计费。 |
InternetMaxBandwidthOut | Integer | 否 | 50 | 公网出带宽最大值,单位为Mbps(Mega bit per second)。取值范围:
|
SystemDisk.Category | String | 否 | cloud_ssd | 系统盘的磁盘种类。取值范围:
该参数不能与 |
SystemDisk.Size | Integer | 否 | 100 | 系统盘的大小,单位:GiB。取值范围:
指定该参数后,系统盘大小必须大于等于max{20, ImageSize}。 默认值:max{40, ImageSize}。 |
SystemDisk.DiskName | String | 否 | cloud_ssdSystem | 系统盘的名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头,不能以 |
SystemDisk.Description | String | 否 | Test system disk. | 系统盘的描述。长度为2~256个英文或中文字符,不能以 |
SystemDisk.AutoSnapshotPolicyId | String | 否 | sp-bp12m37ccmxvbmi5**** | 系统盘使用的自动快照策略ID。 |
SystemDisk.PerformanceLevel | String | 否 | PL1 | 当系统盘为ESSD云盘时,设置云盘的性能等级。取值范围:
默认值:PL1。 说明 关于如何选择ESSD云盘性能等级,请参见ESSD云盘。 |
ScalingConfigurationName | String | 否 | scalingconfig**** | 伸缩配置的名称,2~64英文或中文字符,以数字、大小写字母或中文开头,可包含数字、下划线(_)、短划线(-)或半角句号(.)。 在同一地域下同一伸缩组内伸缩配置名称唯一。如果您没有指定该参数,则默认使用伸缩配置的ID。 |
LoadBalancerWeight | Integer | 否 | 50 | ECS实例作为负载均衡后端服务器时的权重,取值范围:1~100。 默认值:50。 |
Tags | String | 否 | {"key1":"value1","key2":"value2", ... "key5":"value5"} | ECS实例的标签。标签以键值对方式传入,最多可以使用20组标签。Key和Value的使用要求如下:
|
UserData | String | 否 | ZWNobyBoZWxsbyBlY3Mh | ECS实例的自定义数据,需要以Base64方式编码,编码前的原始数据最多为32 KB。 |
KeyPairName | String | 否 | KeyPairTest | 登录ECS实例时使用的密钥对的名称。
|
RamRoleName | String | 否 | ramrole**** | ECS实例的RAM角色名称。RAM角色名称由RAM提供和维护,您可调用ListRoles查询可用的RAM角色。创建RAM角色的具体操作,请参见CreateRole。 |
SecurityEnhancementStrategy | String | 否 | Active | 是否开启安全加固。取值范围:
|
InstanceName | String | 否 | instance**** | 使用本伸缩配置自动创建的ECS实例的名称。 |
HostName | String | 否 | host**** | 云服务器的主机名。半角句号(.)或短划线(-)不能作为首尾字符,不能连续使用半角句号(.)或短划线(-)。另外,不同类型实例的命名要求如下:
|
SpotStrategy | String | 否 | NoSpot | 后付费实例的抢占策略。取值范围:
默认值:NoSpot。 |
PasswordInherit | Boolean | 否 | false | 是否使用镜像预设的密码。使用该参数时,您需要确保使用的镜像已经设置了密码。取值范围:
|
Password | String | 否 | 123abc**** | ECS实例的密码。长度为8至30个字符,必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是:
其中,Windows实例不能以斜线号(/)为密码首字符。 说明 如果传入Password参数,建议您使用HTTPS协议发送请求,避免密码泄露。 |
ResourceGroupId | String | 否 | rg-resource**** | ECS实例所属资源组的ID。 |
HpcClusterId | String | 否 | hpc-clusterid | ECS实例所属的HPC集群的ID。 |
InstanceDescription | String | 否 | Test instance. | ECS实例的描述。长度为2~256个英文或中文字符,不能以 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保证请求幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性。 |
Ipv6AddressCount | Integer | 否 | 1 | 为弹性网卡指定随机生成的IPv6地址数量。 |
CreditSpecification | String | 否 | Standard | 指定突发性能实例的运行模式。取值范围:
更多信息,请参见突发性能实例概述下的性能模式章节。 |
ImageFamily | String | 否 | hangzhou-daily-update | 镜像族系名称,通过设置该参数来获取当前镜像族系内最新的可用镜像,用于创建实例。如果已经设置了参数 |
ZoneId | String | 否 | cn-hangzhou-g | ECS实例所属的可用区ID。 |
DedicatedHostId | String | 否 | dh-bp67acfmxazb4p**** | 是否在专有宿主机上创建ECS实例。由于专有宿主机不支持创建抢占式实例,指定DedicatedHostId参数后,会自动忽略请求中的SpotStrategy和SpotPriceLimit设置。 您可以调用DescribeDedicatedHosts查询专有宿主机ID列表。 |
Affinity | String | 否 | default | 专有宿主机实例是否与专有宿主机关联。取值范围:
默认值:default。 |
Tenancy | String | 否 | default | 是否在专有宿主机上创建实例。取值范围:
默认值:default。 |
SchedulerOptions | Map | 否 | ["testManagedPrivateSpaceId****"] | 调度选项。 |
PrivatePoolOptions.MatchCriteria | String | 否 | Open | 实例启动的私有池容量选项。弹性保障服务或容量预定服务在生效后会生成私有池容量,供实例启动时选择。取值范围:
|
PrivatePoolOptions.Id | String | 否 | eap-bp67acfmxazb4**** | 私有池ID。即弹性保障服务ID或容量预定服务ID。 |
SpotDuration | Integer | 否 | 1 | 抢占式实例的保留时长,单位为小时。取值范围:
默认值:1。 |
SpotInterruptionBehavior | String | 否 | Terminate | 抢占实例中断模式。目前仅支持Terminate(默认)直接释放实例。 |
InstanceTypes.N | String | 否 | ecs.g6.large | 多种实例规格参数。其中N的取值范围:1~10,即一个伸缩配置内最多可以设置10种实例规格。 N代表当前伸缩配置中实例规格的优先级,编号为1的实例规格优先级最高,实例规格优先级随着编号的增大依次降低。当无法根据优先级较高的实例规格创建出实例时,弹性伸缩服务会自动选择下一优先级的实例规格来创建实例。 说明 InstanceType、InstanceTypes、InstanceTypeOverrides、Cpu和Memory这四种方式不能同时指定,但InstanceTypes可以与InstancePatternInfo同时指定。此时,弹性伸缩优先使用您指定的实例规格扩容,当指定的实例规格无库存时,再使用符合InstancePatternInfo配置的实例规格。 |
InstanceTypeOverride.N.InstanceType | String | 否 | ecs.c5.xlarge | 当您需要指定伸缩配置中实例规格的容量时,请同时指定本参数和InstanceTypeOverride.N.WeightedCapacity。 本参数用于指定实例规格。您可以指定N个本参数,结合InstanceTypeOverride.N.WeightedCapacity参数,扩展多实例规格支持自定义权重。N的取值范围:1~10。 说明 指定本参数时,不允许同时指定InstanceTypes.N或InstanceType。 InstanceType的取值范围:在售的ECS实例规格,请参见实例规格族。 |
InstanceTypeOverride.N.WeightedCapacity | Integer | 否 | 4 | 当您需要指定伸缩配置中实例规格的容量时,先指定InstanceTypeOverride.N.InstanceType后,再指定本参数。两个参数一一对应,N需要保持一致。 本参数用于指定实例规格的权重,即实例规格的单台实例在伸缩组中表示的容量大小。权重越大,满足期望容量所需的本实例规格的实例数量越少。 由于每个实例规格的vCPU个数、内存大小等性能指标会有差异,您可以根据自身需求,给不同的实例规格配置不同的权重。 例如:
为满足期望容量,伸缩组将为用户扩容2台ecs.c5.xlarge实例。 说明 扩容时伸缩组的容量不得超过最大容量(MaxSize)与实例规格的最大权重之和。 WeightedCapacity的取值范围:1~500。 |
DataDisk.N.PerformanceLevel | String | 否 | PL1 | 当数据盘为ESSD云盘时,设置云盘的性能等级。N的取值必须和DataDisk.N.Category=cloud_essd中的N保持一致。取值范围:
默认值:PL1。 说明 关于如何选择ESSD云盘性能等级,请参见ESSD云盘。 |
DataDisk.N.AutoSnapshotPolicyId | String | 否 | sp-bp19nq9enxqkomib**** | 数据盘使用的自动快照策略ID,N的取值范围:1~16。 |
DataDisk.N.Encrypted | String | 否 | false | 数据盘N是否加密,N的取值范围:1~16。该参数取值范围:
默认值:false。 |
DataDisk.N.Description | String | 否 | Test data disk. | 数据盘的描述,N的取值范围:1~16。长度为2~256个英文或中文字符,不能以 |
DataDisk.N.SnapshotId | String | 否 | s-280s7**** | 创建数据盘时使用的快照,N的取值范围:1~16。指定该参数后,DataDisk.N.Size会被忽略,实际创建的磁盘大小为指定快照的大小。 如果该快照创建于2013年7月15日或之前,调用会被拒绝,返回参数中会提示InvalidSnapshot.TooOld。 |
DataDisk.N.Categories.N | String | 否 | cloud | 数据盘N的多磁盘类型。第一个N表示第N块数据盘,取值范围:1~16。第二个N表示第N块数据盘的第N种磁盘类型,取值范围:1~4,即一个伸缩配置内最多可以为数据盘指定4种磁盘类型。N越小,优先级越高。当无法使用高优先级的磁盘类型时,弹性伸缩自动尝试下一优先级的磁盘类型创建数据盘。取值范围:
说明 指定本参数时,不允许同时指定 DataDisk.N.Category 。 |
DataDisk.N.Size | Integer | 否 | 100 | 数据盘N的磁盘大小,N的取值范围:1~16,内存单位为GiB。取值范围:
指定该参数后,磁盘大小必须大于等于快照大小(快照通过SnapshotId指定)。 |
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个英文或中文字符。必须以大小写字母或中文开头,不能以 |
DataDisk.N.Category | String | 否 | cloud_ssd | 数据盘N的磁盘种类,N的取值范围:1~16。该参数取值范围:
该参数不能与
|
DataDisk.N.DeleteWithInstance | Boolean | 否 | true | 指定数据盘是否随实例释放,N的取值范围:1~16。该参数取值范围:
该参数只可对独立云盘设置(DataDisk.N.Category为cloud、cloud_efficiency、cloud_ssd、cloud_essd或者cloud_auto),否则会出现报错。 默认值:true。 |
DataDisk.N.KMSKeyId | String | 否 | 0e478b7a-4262-4802-b8cb-00d3fb40**** | 数据盘对应的KMS密钥的ID,N的取值范围:1~16。 |
DataDisk.N.ProvisionedIops | Long | 否 | 100 | 数据盘预配置的IOPS(Input/Output Operations Per Second)性能指标。 说明 IOPS(Input/Output Operations Per Second)指每秒能处理的I/O个数,表示块存储处理读写(输出/输入)的能力,单位为次/秒。 |
DataDisk.N.BurstingEnabled | Boolean | 否 | false | 数据盘是否开启Burst(性能突发)。取值范围:
更多信息,请参见ESSD AutoPL云盘。 |
SpotPriceLimit.N.PriceLimit | Float | 否 | 0.5 | 抢占式实例对应的出价,N的取值范围:1~10。SpotStrategy取值为SpotWithPriceLimit时生效。 |
SpotPriceLimit.N.InstanceType | String | 否 | ecs.g6.large | 抢占式实例的实例规格,N的取值范围:1~10。SpotStrategy取值为SpotWithPriceLimit时生效。 |
SecurityGroupIds.N | String | 否 | sg-bp18kz60mefs**** | 将ECS实例同时加入多个安全组。N的取值范围与实例能够加入安全组上限有关。更多信息,请参见使用限制下的安全组章节。 说明 不支持同时指定SecurityGroupId和SecurityGroupIds.N。 |
InstancePatternInfo.N.Cores | Integer | 否 | 2 | 智能配置模式下,实例规格的vCPU内核数目,用于筛选符合要求的实例规格范围。更多信息,请参见实例规格族。N的取值范围:1~10。 请注意以下信息:
|
InstancePatternInfo.N.InstanceFamilyLevel | String | 否 | EnterpriseLevel | 智能配置模式下,实例规格族级别,用于筛选符合要求的实例规格范围。取值范围:
N的取值范围:1~10。 |
InstancePatternInfo.N.MaxPrice | Float | 否 | 2 | 智能配置模式下,按量付费实例或者抢占式实例可接受的每小时最高价格,用于筛选符合要求的实例规格范围。N的取值范围:1~10。 说明 SpotStrategy设置为SpotWithPriceLimit时,该参数必选。其他情况下,该参数可选。 |
InstancePatternInfo.N.Memory | Float | 否 | 4 | 智能配置模式下,实例规格的内存大小,单位为GiB,用于筛选符合要求的实例规格范围。更多信息,请参见实例规格族。N的取值范围:1~10。 |
InstancePatternInfo.N.ExcludedInstanceType.N | String | 否 | ecs.n1.small/ecs.n1.*/*7* | 需要排除的实例规格。通过使用通配符(*)可以排除单个规格或者整个规格族。例如:
|
InstancePatternInfo.N.Architecture.N | String | 否 | X86 | 实例规格所属的架构类型。取值范围:
默认值:包含所有架构类型。 |
InstancePatternInfo.N.BurstablePerformance | String | 否 | Include | 是否为性能突发实例规格。取值范围:
默认值:Include。 |
InstancePatternInfo.N.InstanceTypeFamilies.N | String | 否 | ecs.g6 | 指定的实例规格族。N表示可以设置多个实例规格族,N的取值范围:1~10。 |
InstancePatternInfo.N.MinimumCpuCoreCount | Integer | 否 | 2 | 实例规格的最小vCPU内核数目。 |
InstancePatternInfo.N.MaximumCpuCoreCount | Integer | 否 | 4 | 实例规格的最大vCPU内核数目。 说明 MaximumCpuCoreCount 参数值不能超过MinimumCpuCoreCount 参数值的4倍。 |
InstancePatternInfo.N.GpuSpecs.N | String | 否 | NVIDIA V100 | GPU 类型。 |
InstancePatternInfo.N.InstanceCategories.N | String | 否 | Compute-optimized with GPU | 实例分类。取值范围: 说明 N表示可以设置多个实例分类,N的取值范围:1~10。
|
InstancePatternInfo.N.CpuArchitectures.N | String | 否 | X86 | 实例的CPU架构。取值范围: 说明 N表示可以设置多个CPU架构,N的取值范围:1~2。
|
InstancePatternInfo.N.PhysicalProcessorModels.N | String | 否 | Intel Xeon(Ice Lake) Platinum 8369B", "Intel Xeon(Skylake) Platinum 8163", … "Intel Xeon(Cascade Lake) Platinum 8269CY | 实例的处理器型号。N表示可以设置多个处理器型号,N的取值范围:1~10。 |
InstancePatternInfo.N.MinimumEniQuantity | Integer | 否 | 2 | 实例最小支持挂载的弹性网卡上限。 |
InstancePatternInfo.N.MinimumEniPrivateIpAddressQuantity | Integer | 否 | 2 | 实例最小单块弹性网卡的IPv4地址上限。 |
InstancePatternInfo.N.MinimumEniIpv6AddressQuantity | Integer | 否 | 1 | 实例最小单块弹性网卡的IPv6地址上限。 |
InstancePatternInfo.N.MinimumInitialCredit | Integer | 否 | 12 | 实例最小突发性能实例t5、t6的初始vCPU积分值。 |
InstancePatternInfo.N.MinimumBaselineCredit | Integer | 否 | 12 | 实例最小突发性能实例t5、t6的基准vCPU计算性能(所有vCPU之和)。 |
InstancePatternInfo.N.MinimumMemorySize | Float | 否 | 4 | 实例最小内存。单位:GiB。 |
InstancePatternInfo.N.MaximumMemorySize | Float | 否 | 4 | 实例最大内存。单位:GiB。 |
InstancePatternInfo.N.MinimumGpuAmount | Integer | 否 | 2 | 实例最小 GPU 数目。取值范围:正整数。 |
InstancePatternInfo.N.MaximumGpuAmount | Integer | 否 | 2 | 实例最大 GPU 数目。取值范围:正整数。 |
SystemDiskCategories.N | String | 否 | cloud | 系统盘的多磁盘类型。N的取值范围:1~4,即一个伸缩配置内最多可以为系统盘指定4种磁盘类型。N越小,优先级越高。当无法使用高优先级的磁盘类型时,弹性伸缩自动尝试下一优先级的磁盘类型创建系统盘。取值范围:
说明 指定本参数时,不允许同时指定 SystemDisk.Category 。 |
SystemDisk.Encrypted | Boolean | 否 | false | 是否加密系统盘。取值范围:
默认值:false。 |
SystemDisk.KMSKeyId | String | 否 | 0e478b7a-4262-4802-b8cb-00d3fb40**** | 系统盘使用的KMS密钥ID。 |
SystemDisk.EncryptAlgorithm | String | 否 | AES-256 | 系统盘采用的加密算法。取值范围:
默认值:AES-256。 |
SystemDisk.ProvisionedIops | Long | 否 | 100 | 系统盘预配置的IOPS(Input/Output Operations Per Second)性能指标。 说明 IOPS(Input/Output Operations Per Second)指每秒能处理的I/O个数,表示块存储处理读写(输出/输入)的能力,单位为次/秒。 |
SystemDisk.BurstingEnabled | Boolean | 否 | false | 系统盘是否开启Burst(性能突发)。取值范围:
更多信息,请参见ESSD AutoPL云盘。 |
ImageOptions.LoginAsNonRoot | Boolean | 否 | false | ECS实例是否使用
默认值:false。 |
DeletionProtection | Boolean | 否 | false | ECS实例释放保护属性。该项仅适用于按量付费实例,指是否支持通过ECS管理控制台或API(DeleteInstance)直接释放实例。取值范围:
默认值:false。 说明 该属性不影响弹性伸缩正常的缩容活动,即弹性伸缩发生缩容活动时,开启实例释放保护的按量付费实例可以被正常释放掉。 |
StorageSetId | String | 否 | ss-bp67acfmxazb4p**** | 存储集ID。 |
StorageSetPartitionNumber | Integer | 否 | 2 | 存储集中的最大分区数量。取值为大于等于2的整数。 |
CustomPriorities.N.InstanceType | String | 否 | ecs.g6.large |
说明 该参数仅在伸缩组的 扩缩容策略 为优先级策略 时有效,且该实例规格(InstanceType)必须包含在伸缩配置的实例规格列表中。当无法根据优先级较高的ECS实例规格+虚拟交换机创建ECS实例时,弹性伸缩服务会自动选择下一优先级的ECS实例规格+虚拟交换机组合来创建ECS实例。 说明 如果仅指定了部分ECS实例规格+虚拟交换机组合的自定义优先级,则未指定的组合优先级低于指定的组合优先级,且未指定的组合仍会依次按照伸缩组的虚拟交换机顺序、伸缩配置的实例规格顺序确定优先级。例如:伸缩组的虚拟交换机顺序依次为vsw1、vsw2,伸缩配置的实例规格顺序依次为type1、type2,该组合的自定义优先级顺序为 ["vsw2+type2", "vsw1+type2"] ,则最终优先级为vsw2+type2 > vsw1+type2 > vsw1+type1 > vsw2+type1 。 |
CustomPriorities.N.VswitchId | String | 否 | vsw-bp14zolna43z266bq**** |
说明 该参数仅在伸缩组的 扩缩容策略 为优先级策略 时有效,且该交换机(Vswitch)必须包含在伸缩组的交换机列表中。 |
NetworkInterfaces.N.InstanceType | String | 否 | Primary | 弹性网卡类型。使用
默认值:Secondary。 |
NetworkInterfaces.N.NetworkInterfaceTrafficMode | String | 否 | HighPerformance | 网卡的通讯模式。取值范围:
默认值:Standard。 说明 RDMA模式的弹性网卡数量不能超过该实例规格族的限制。更多信息,请参见实例规格族。 |
NetworkInterfaces.N.Ipv6AddressCount | Integer | 否 | 1 | 为主网卡指定随机生成的IPv6地址数量。您需要注意以下事项:
|
NetworkInterfaces.N.SecurityGroupIds.N | String | 否 | sg-uf6ij8dwxh**** | 弹性网卡所属的一个或多个安全组 ID。您需要注意以下事项:
|
DedicatedHostClusterId | String | 否 | dc-2zedxc67zqzt7lb4**** | 专有宿主机集群ID。 |
SecurityOptions.ConfidentialComputingMode | String | 否 | TDX | 机密计算模式。可能值:
|
返回数据
名称 |
类型 |
示例值 |
描述 |
ScalingConfigurationId | String | asc-bp1ffogfdauy0nu5**** | 伸缩配置ID。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 请求ID。 |
示例
请求示例
http(s)://ess.aliyuncs.com/?Action=CreateScalingConfiguration
&ScalingGroupId=asg-bp14wlu85wrpchm0****
&ImageId=centos6u5_64_20G_aliaegis****.vhd
&ImageName=image****
&InstanceType=ecs.g6.large
&Cpu=2
&Memory=16
&DeploymentSetId=ds-bp1frxuzdg87zh4pz****
&SecurityGroupId=sg-280ih****
&IoOptimized=optimized
&InternetChargeType=PayByTraffic
&InternetMaxBandwidthIn=100
&InternetMaxBandwidthOut=50
&SystemDisk.Category=cloud_ssd
&SystemDisk.Size=100
&SystemDisk.DiskName=cloud_ssdSystem
&SystemDisk.Description=Test system disk.
&SystemDisk.AutoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&SystemDisk.PerformanceLevel=PL1
&ScalingConfigurationName=scalingconfig****
&LoadBalancerWeight=50
&Tags={"key1":"value1","key2":"value2", ... "key5":"value5"}
&UserData=ZWNobyBoZWxsbyBlY3Mh
&KeyPairName=KeyPairTest
&RamRoleName=ramrole****
&SecurityEnhancementStrategy=Active
&InstanceName=instance****
&HostName=host****
&SpotStrategy=NoSpot
&PasswordInherit=false
&Password=123abc****
&ResourceGroupId=rg-resource****
&HpcClusterId=hpc-clusterid
&InstanceDescription=Test instance.
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Ipv6AddressCount=1
&CreditSpecification=Standard
&ImageFamily=hangzhou-daily-update
&ZoneId=cn-hangzhou-g
&DedicatedHostId=dh-bp67acfmxazb4p****
&Affinity=default
&Tenancy=default
&PrivatePoolOptions.MatchCriteria=Open
&PrivatePoolOptions.Id=eap-bp67acfmxazb4****
&SpotDuration=1
&SpotInterruptionBehavior=Terminate
&InstanceTypes=["ecs.g6.large"]
&InstanceTypeOverride=[{"InstanceType":"ecs.c5.xlarge","WeightedCapacity":4}]
&DataDisk=[{"PerformanceLevel":"PL1","AutoSnapshotPolicyId":"sp-bp19nq9enxqkomib****","Encrypted":"false","Description":"Test data disk.","SnapshotId":"s-280s7****","Categories":["cloud"],"Size":100,"Device":"/dev/xvdb","DiskName":"cloud_ssdData","Category":"cloud_ssd","DeleteWithInstance":true,"KMSKeyId":"0e478b7a-4262-4802-b8cb-00d3fb40****","ProvisionedIops":100,"BurstingEnabled":false}]
&SpotPriceLimit=[{"PriceLimit":0.5,"InstanceType":"ecs.g6.large"}]
&SecurityGroupIds=["sg-bp18kz60mefs****"]
&InstancePatternInfo=[{"Cores":2,"InstanceFamilyLevel":"EnterpriseLevel","MaxPrice":2.0,"Memory":4.0,"ExcludedInstanceType":["ecs.n1.small/ecs.n1.*/*7*"],"Architecture":["X86"],"BurstablePerformance":"Include","InstanceTypeFamilies":["[\"ecs.g6\", \"ecs.c6\", … \"ecs.r6\"]"],"MinimumCpuCoreCount":2,"MaximumCpuCoreCount":4,"GpuSpecs":["NVIDIA V100"],"InstanceCategories":["[\"Compute-optimized with GPU\" ]"],"CpuArchitectures":["[\"X86\", \"ARM\" ]"],"PhysicalProcessorModels":["[\"Intel Xeon(Ice Lake) Platinum 8369B\", \"Intel Xeon(Skylake) Platinum 8163\", … \"Intel Xeon(Cascade Lake) Platinum 8269CY\"]"],"MinimumEniQuantity":2,"MinimumEniPrivateIpAddressQuantity":2,"MinimumEniIpv6AddressQuantity":1,"MinimumInitialCredit":12,"MinimumBaselineCredit":12,"MinimumMemorySize":4.0,"MaximumMemorySize":4.0,"MinimumGpuAmount":2,"MaximumGpuAmount":2}]
&SystemDiskCategories=["cloud"]
&SystemDisk.Encrypted=false
&SystemDisk.KMSKeyId=0e478b7a-4262-4802-b8cb-00d3fb40****
&SystemDisk.EncryptAlgorithm=AES-256
&SystemDisk.ProvisionedIops=100
&SystemDisk.BurstingEnabled=false
&ImageOptions.LoginAsNonRoot=false
&DeletionProtection=false
&StorageSetId=ss-bp67acfmxazb4p****
&StorageSetPartitionNumber=2
&CustomPriorities=[{"InstanceType":"ecs.g6.large","VswitchId":"vsw-bp14zolna43z266bq****"}]
&NetworkInterfaces=[{"InstanceType":"Primary","NetworkInterfaceTrafficMode":"HighPerformance","Ipv6AddressCount":1,"SecurityGroupIds":["sg-uf6ij8dwxh****"]}]
&DedicatedHostClusterId=dc-2zedxc67zqzt7lb4****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateScalingConfigurationResponse>
<ScalingConfigurationId>asc-bp1ffogfdauy0nu5****</ScalingConfigurationId>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateScalingConfigurationResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"ScalingConfigurationId" : "asc-bp1ffogfdauy0nu5****",
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
错误码
访问错误中心查看更多错误码。
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. |
临时磁盘数据盘总容量超过2 TiB(2048 GiB)。 |
400 |
QuotaExceeded.ScalingConfiguration |
Scaling configuration quota exceeded in the specified scaling group. |
您目前拥有的伸缩配置个数已经达到上限。 |
400 |
QuotaExceeded.SecurityGroupInstance |
Instance quota exceeded in the specified security group. |
指定的安全组中添加的ECS实例个数已经达到上限。 |
400 |
InvalidSecurityGroupId.IncorrectType |
The managed security group "XXX" is not supported. |
不支持 "XXX" 托管安全组。 |