弹性伸缩：CreateScalingConfiguration

系统规定参数。取值：CreateScalingConfiguration。

伸缩配置所属的伸缩组的ID。

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

镜像文件名称，同一个地域内镜像名称唯一。不支持通过该参数设置镜像市场中的镜像。

ECS实例的一种实例规格，更多信息，请参见实例规格族。

vCPU个数。单位：核。

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

内存大小。单位：GiB。

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

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

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

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

• none：非I/O优化实例。
• optimized：I/O优化实例。

已停售的实例规格的实例默认值是none，其他实例规格的实例默认值是optimized。

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

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

如果未指定该参数，经典网络下默认值为PayByBandwidth，专有网络VPC下默认值为PayByTraffic。

公网入带宽最大值，单位为 Mbit/s。取值范围：

• 当所购公网出带宽小于等于 10 Mbit/s 时：1~10，默认为 10。
• 当所购公网出带宽大于 10 Mbit/s 时：1~InternetMaxBandwidthOut的取值，默认为InternetMaxBandwidthOut的取值。

公网出带宽最大值，单位为 Mbit/s。取值范围：0~100。

默认值：0。

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

• cloud：普通云盘。
• cloud_efficiency：高效云盘。
• cloud_ssd：SSD云盘。
• ephemeral_ssd：本地SSD盘。
• cloud_essd：ESSD云盘。
• cloud_auto：ESSD AutoPL云盘。

该参数不能与SystemDiskCategories.N同时指定。当该参数与SystemDiskCategories.N都未指定时，该参数有默认值。InstanceType为系列I的实例规格且实例属于非I/O优化实例时，默认值：cloud。否则，默认值：cloud_efficiency。

系统盘的大小，单位：GiB。取值范围：

• cloud：20~500。
• cloud_efficiency：20~500。
• cloud_ssd：20~500。
• cloud_essd：20~500。
• ephemeral_ssd：20~500。

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

默认值：max{40, ImageSize}。

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

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

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

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

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

默认值：PL1。

伸缩配置的名称，2~64英文或中文字符，以数字、大小写字母或中文开头，可包含数字、下划线（_）、短划线（-）或半角句号（.）。

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

ECS实例作为负载均衡后端服务器时的权重，取值范围：1~100。

默认值：50。

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

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

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

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

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

ECS实例的RAM角色名称。RAM角色名称由RAM提供和维护，您可调用ListRoles查询可用的RAM角色。创建RAM角色的具体操作，请参见CreateRole。

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

• Active：启用安全加固，只对公共镜像生效。
• Deactive：不启用安全加固，对所有镜像类型生效。

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

云服务器的主机名。半角句号（.）或短划线（-）不能作为首尾字符，不能连续使用半角句号（.）或短划线（-）。另外，不同类型实例的命名要求如下：

• Windows实例：主机名长度为2~15，可以包含大小写字母、数字和短划线（-）。不能包含半角句号（.），不能全是数字。
• 其他类型实例（Linux等）：主机名长度为2~64，可以包含多个半角句号（.）。两个半角句号（.）之间为一段，每段可以包含大小写字母、数字和短划线（-）。

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

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

默认值：NoSpot。

是否使用镜像预设的密码。使用该参数时，您需要确保使用的镜像已经设置了密码。取值范围：

• true：使用镜像预设密码。
• false：不使用镜像预设密码。

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

()` ~!@#$%^&*-_+=\|{}[]:;'<>,.?/

其中，Windows实例不能以斜线号（/）为密码首字符。

ECS实例所属资源组的ID。

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

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

保证请求幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。

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

指定突发性能实例的运行模式。取值范围：

• Standard：标准模式。
• Unlimited：无性能约束模式。

更多信息，请参见突发性能实例概述下的性能模式章节。

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

ECS实例所属的可用区ID。

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

您可以调用DescribeDedicatedHosts查询专有宿主机ID列表。

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

• default：实例不与专有宿主机关联。已启用节省停机模式的实例，停机后再次启动时，若原专有宿主机可用资源不足，则实例被放置在自动部署资源池的其他专有宿主机上。
• host：实例与专有宿主机关联。已启用节省停机模式的实例，停机后再次启动时，仍放置在原专有宿主机上。若原专有宿主机可用资源不足，则实例重启失败。

默认值：default。

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

• default：创建非专有宿主机实例。
• host：创建专有宿主机实例。若您不指定DedicatedHostId，则由阿里云自动选择专有宿主机放置实例。

默认值：default。

调度选项。

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

• Open：开放模式。将自动匹配开放类型的私有池容量。如果没有符合条件的私有池容量，则使用公共池资源启动。该模式下无需设置PrivatePoolOptions.Id参数。
• Target：指定模式。使用指定的私有池容量启动实例，如果该私有池容量不可用，则实例会启动失败。该模式下必须指定私有池ID，即PrivatePoolOptions.Id参数为必填项。
• None：不使用模式。实例启动将不使用私有池容量。

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

抢占式实例的保留时长，单位为小时。取值范围：

• 1：创建后阿里云会保证实例运行1小时不会被自动释放；超过1小时后，系统会自动比较出价与市场价格、检查资源库存，来决定实例的保留或回收。

• 0：创建后，阿里云不能保证实例运行1小时，系统会自动比较出价与市场价格、检查资源库存，来决定实例的保留或回收。

  说明 实例被回收前5分钟内，阿里云会通过ECS系统事件向您发送通知。抢占式实例按秒计费，建议您结合具体任务执行耗时来选择合适的保留时长。

默认值：1。

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

多种实例规格参数。其中N的取值范围：1~10，即一个伸缩配置内最多可以设置10种实例规格。

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

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

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

InstanceType的取值范围：在售的ECS实例规格，请参见实例规格族。

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

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

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

例如：

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

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

WeightedCapacity的取值范围：1~500。

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

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

默认值：PL1。

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

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

• true：加密。
• false：不加密。

默认值：false。

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

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

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

数据盘N的多磁盘类型。第一个N表示第N块数据盘，取值范围：1~16。第二个N表示第N块数据盘的第N种磁盘类型，取值范围：1~4，即一个伸缩配置内最多可以为数据盘指定4种磁盘类型。N越小，优先级越高。当无法使用高优先级的磁盘类型时，弹性伸缩自动尝试下一优先级的磁盘类型创建数据盘。取值范围：

• cloud：普通云盘。随实例创建的普通云盘的DeleteWithInstance属性为true。
• cloud_efficiency：高效云盘。
• cloud_ssd：SSD云盘。
• cloud_essd：ESSD云盘。

数据盘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指定）。

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

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

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

• cloud：普通云盘。随实例创建的普通云盘的DeleteWithInstance属性为true。
• cloud_efficiency：高效云盘。
• cloud_ssd：SSD云盘。
• ephemeral_ssd：本地SSD盘。
• cloud_essd：ESSD云盘。
• cloud_auto：ESSD AutoPL云盘。

该参数不能与DataDisk.N.Categories.N同时指定。当该参数与DataDisk.N.Categories.N都未指定时，该参数默认值：

• 对于I/O优化实例，默认值为cloud_efficiency。
• 对于非I/O优化实例，默认值为cloud。

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

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

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

默认值：true。

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

数据盘预配置的IOPS（Input/Output Operations Per Second）性能指标。

数据盘是否开启Burst（性能突发）。取值范围：

• true：开启。

• false：未开启。

  说明 当DataDisk.Category取值为cloud_auto时才支持设置该参数。

更多信息，请参见ESSD AutoPL云盘。

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

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

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

智能配置模式下，实例规格的vCPU内核数目，用于筛选符合要求的实例规格范围。更多信息，请参见实例规格族。N的取值范围：1~10。

请注意以下信息：

• InstancePatternInfo.N参数仅适用于伸缩组的网络类型为专有网络。
• InstancePatternInfo.N参数必须同时配置InstancePatternInfo.N.Cores和InstancePatternInfo.N.Memory。
• 如果您已经通过InstanceType或InstanceTypes.N参数指定了实例规格，弹性伸缩优先使用您指定的实例规格扩容，当指定的实例规格无库存时，再从符合InstancePatternInfo.N参数值的实例规格中优先使用价格最低的实例规格扩容。

智能配置模式下，实例规格族级别，用于筛选符合要求的实例规格范围。取值范围：

• EntryLevel：入门级，即共享型实例规格。成本更低，但是无法保证实例计算性能的稳定。适用于平时CPU使用率低的业务场景。更多信息，请参见共享型。
• EnterpriseLevel：企业级。性能稳定，资源独享，适用于对稳定性要求高的业务场景。更多信息，请参见实例规格族。
• CreditEntryLevel：积分入门级，即突发性能实例。通过CPU积分来保证计算性能，适用于平时CPU使用率低、偶有突发CPU使用率的情况。更多信息，请参见突发性能实例。

N的取值范围：1~10。

智能配置模式下，按量付费实例或者抢占式实例可接受的每小时最高价格，用于筛选符合要求的实例规格范围。N的取值范围：1~10。

智能配置模式下，实例规格的内存大小，单位为GiB，用于筛选符合要求的实例规格范围。更多信息，请参见实例规格族。N的取值范围：1~10。

需要排除的实例规格。通过使用通配符（*）可以排除单个规格或者整个规格族。例如：

• ecs.c6.large：表示排除ecs.c6.large实例规格。
• ecs.c6.*：表示排除整个c6规格族的实例规格。

实例规格所属的架构类型。取值范围：

• X86：X86计算。
• Heterogeneous：异构计算，例如GPU或FPGA等。
• BareMetal：弹性裸金属服务器。
• Arm：Arm计算。
• SuperComputeCluster：超级计算集群。

默认值：包含所有架构类型。

是否为性能突发实例规格。取值范围：

• Exclude：不包含性能突发实例规格。
• Include：包含性能突发实例规格。
• Required：只包含性能突发实例规格。

默认值：Include。

指定的实例规格族。N表示可以设置多个实例规格族，N的取值范围：1~10。

实例规格的最小vCPU内核数目。

实例规格的最大vCPU内核数目。

GPU 类型。

实例分类。取值范围：

• General-purpose：通用型。
• Compute-optimized：计算型。
• Memory-optimized：内存型。
• Big data：大数据型。
• Local SSDs：本地SSD型。
• High Clock Speed：高主频型。
• Enhanced：增强型。
• Shared：共享型。
• Compute-optimized with GPU：GPU计算型。
• Visual Compute-optimized：视觉计算型。
• Heterogeneous Service：异构服务型。
• Compute-optimized with FPGA：FPGA计算型。
• Compute-optimized with NPU：NPU计算型。
• ECS Bare Metal：弹性裸金属服务器。
• Super Computing Cluster：超级计算集群。
• High Performance Compute：高性能计算型。

实例的CPU架构。取值范围：

• X86。
• ARM。

实例的处理器型号。N表示可以设置多个处理器型号，N的取值范围：1~10。

实例最小支持挂载的弹性网卡上限。

实例最小单块弹性网卡的IPv4地址上限。

实例最小单块弹性网卡的IPv6地址上限。

实例最小突发性能实例t5、t6的初始vCPU积分值。

实例最小突发性能实例t5、t6的基准vCPU计算性能（所有vCPU之和）。

实例最小内存。单位：GiB。

实例最大内存。单位：GiB。

实例最小 GPU 数目。取值范围：正整数。

实例最大 GPU 数目。取值范围：正整数。

系统盘的多磁盘类型。N的取值范围：1~4，即一个伸缩配置内最多可以为系统盘指定4种磁盘类型。N越小，优先级越高。当无法使用高优先级的磁盘类型时，弹性伸缩自动尝试下一优先级的磁盘类型创建系统盘。取值范围：

• cloud：普通云盘。
• cloud_efficiency：高效云盘。
• cloud_ssd：SSD云盘。
• cloud_essd：ESSD云盘。

是否加密系统盘。取值范围：

• true：加密。
• false：不加密。

默认值：false。

系统盘使用的KMS密钥ID。

系统盘采用的加密算法。取值范围：

• AES-256。
• SM4-128。

默认值：AES-256。

系统盘预配置的IOPS（Input/Output Operations Per Second）性能指标。

系统盘是否开启Burst（性能突发）。取值范围：

• true：开启。

• false：未开启。

  说明 当SystemDisk.Category取值为cloud_auto时才支持设置该参数。

更多信息，请参见ESSD AutoPL云盘。

ECS实例是否使用ecs-user用户登录，更多信息，请参见管理ECS实例的登录名。取值范围：

• true：是。
• false：否。

默认值：false。

ECS实例释放保护属性。该项仅适用于按量付费实例，指是否支持通过ECS管理控制台或API（DeleteInstance）直接释放实例。取值范围：

• true：开启实例释放保护属性，表示不支持通过ECS管理控制台或API直接释放实例（即防止弹性伸缩中扩容的实例被误删）。
• false：关闭实例释放保护属性，表示支持通过ECS管理控制台或API直接释放实例。

默认值：false。

存储集ID。

存储集中的最大分区数量。取值为大于等于2的整数。

CustomPriorities字段表示ECS实例规格+虚拟交换机组合的自定义优先级。CustomPriorities.N.InstanceType参数表示自定义优先级中的ECS实例的实例规格。

当无法根据优先级较高的ECS实例规格+虚拟交换机创建ECS实例时，弹性伸缩服务会自动选择下一优先级的ECS实例规格+虚拟交换机组合来创建ECS实例。

CustomPriorities.N.VswitchId参数表示自定义优先级中的虚拟交换机的ID。

弹性网卡类型。使用NetworkInterfaces.N时必须设置主网卡，但不能同时设置SecurityGroupId或SecurityGroupIds.N参数。取值范围：

• Primary：主网卡。
• Secondary：辅助网卡。

默认值：Secondary。

网卡的通讯模式。取值范围：

• Standard：使用TCP通讯模式。
• HighPerformance：开启ERI（Elastic RDMA Interface）接口，使用RDMA通讯模式。

默认值：Standard。

为主网卡指定随机生成的IPv6地址数量。您需要注意以下事项：

• 如果NetworkInterfaces.N.InstanceType取值为Primary时，设置该参数才会生效。
• 如果NetworkInterface.N.InstanceType取值为Secondary或空值，则不能设置该参数。
• 设置该参数后，您不能再设置Ipv6AddressCount参数。

弹性网卡所属的一个或多个安全组 ID。您需要注意以下事项：

• 如果NetworkInterfaces.N.InstanceType取值为Primary时，则必须设置该参数。此时该参数的作用等同于SecurityGroupIds.N，但不能同时再设置SecurityGroupId或SecurityGroupIds.N参数。
• 如果NetworkInterfaces.N.InstanceType取值为Secondary或空值，则该参数为非必填参数。默认值为ECS实例所属的安全组（即主网卡的安全组）。

专有宿主机集群ID。

机密计算模式。可能值：

• Enclave：表示ECS实例使用Enclave构建机密计算环境。更多信息，请参见使用Enclave构建机密计算环境。
• TDX：表示构建TDX机密计算环境。更多信息，请参见构建TDX机密计算环境。

是否启用实例元数据的访问通道。取值范围：

• enabled：启用。
• disabled：禁用。

默认值：enabled。

访问实例元数据时是否强制使用加固模式（IMDSv2）。取值范围：

• optional：不强制使用。
• required：强制使用。设置该取值后，普通模式无法访问实例元数据。

默认值：optional。

伸缩配置ID。

请求ID。