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。取值范围：

• 普通云盘：20~500。

• ESSD 云盘：

  • PL0：1~2048。

  • PL1：20~2048。

  • PL2：461~2048。

  • PL3：1261~2048。

• ESSD AutoPL 云盘：1~2048。

• 其他云盘类型：20~2048。

该参数的取值必须大于或者等于 max{1, 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 小时，系统会自动比较出价与市场价格、检查资源库存，来决定实例的保留或回收。

默认值：1。

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

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

• true：加密。

• false：不加密。

默认值：false。

系统盘使用的 KMS 密钥 ID。

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

• AES-256。

• SM4-128。

默认值：AES-256。

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

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

• true：开启。

• false：未开启。

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

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

• true：是。

• false：否。

默认值：false。

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

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

• false：关闭实例释放保护属性，表示支持通过 ECS 管理控制台或 API 直接释放实例。

默认值：false。

存储集 ID。

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

专有宿主机集群 ID。

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

• enabled：启用。

• disabled：禁用。

默认值：enabled。

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

• optional：不强制使用。

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

默认值：optional。

当辅助网卡设置 VSwitchIds 参数时，是否必须从列表中选择一个可用于辅助弹性网卡的虚拟交换机。

• Strict：严格模式。若 VSwitchIds 中不存在任何满足条件的虚拟交换机，则创建实例失败。

• Tolerant：容错模式。若 VSwitchIds 中不存在任何满足条件的虚拟交换机，则不设置任何辅助网卡，实例仍可正常创建。

默认值：Strict。