AI 助理
文档备案控制台
官方文档
首页

ModifyScalingConfiguration - 修改一个ECS类型伸缩配置

更新时间：
复制 MD 格式
产品详情
我的收藏

如果当前的伸缩配置不满足业务需求，您可以通过调用API ModifyScalingConfiguration修改ECS类型的伸缩配置（即待扩容的ECS实例模板）。

接口说明

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

  • 支持以下任一方式绑定主网卡，但需要注意一次调用只能选用一种方式配置主网卡，同时使用两种方式将会调用失败并返回错误信息。并且修改伸缩配置时，选择一种方式修改网卡配置时，会清空另一种方式设置的网卡配置。

    • 通过 SecurityGroupId、SecurityGroupIds 与 Ipv6AddressCount 等参数直接设置主网卡的相关配置信息。

    • 通过 NetworkInterfaces 设置主网卡以及辅助网卡的配置信息。当使用 NetworkInterfaces 参数时，必须设置主网卡信息，其中 NetworkInterface.InstanceType 取值为 Primary 时，表示设置主网卡；当 NetworkInterface.InstanceType 取值为 Secondary 或空值时，表示设置辅助网卡。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ess:ModifyScalingConfiguration

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

 无 无

请求参数

名称

类型

必填

描述

示例值
ScalingConfigurationId

string

是

待修改伸缩配置的 ID。

asc-bp16har3jpj6fjbx****
IoOptimized

string

否

是否为 I/O 优化实例。可能值：

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

  • optimized：I/O 优化实例。

none
SpotStrategy

string

否

后付费实例的抢占策略。可能值：

  • NoSpot：普通的按量付费实例。

  • SpotWithPriceLimit：设置上限价格的抢占式实例。

  • SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。

NoSpot
ScalingConfigurationName

string

否

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

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

test-modify
InstanceName

string

否

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

inst****
HostName

string

否

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

  • Windows 实例：主机名长度为 2~15 个字符，可以包含大小写字母、数字和短划线（-）。不能包含半角句号（.），不能全是数字。

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

hos****
ImageId

string

否

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

说明

如果伸缩配置之前使用的镜像包括系统盘和数据盘，修改此镜像后，原数据盘信息会被清除。

centos6u5_64_20G_aliaegis_2014****.vhd
ImageName

string

否

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

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

suse11sp3_64_20G_aliaegis_2015****.vhd
Cpu

integer

否

vCPU 个数。单位：核。

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

说明

该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。

2
Memory

integer

否

内存大小。单位：GiB。

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

说明

该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。

16
InternetChargeType

string

否

网络计费类型。可能值：

  • PayByBandwidth：按带宽计费。此时 InternetMaxBandwidthOut 即为所选的固定带宽值。

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

PayByBandwidth
InternetMaxBandwidthOut

integer

否

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

默认值：0。

10
SystemDisk.Category

string

否

系统盘的磁盘种类。可能值：

  • cloud：普通云盘。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

  • ephemeral_ssd：本地 SSD 盘。

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

cloud_efficiency
SystemDisk.Size

integer

否

系统盘大小，单位为 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}。

50
SystemDisk.DiskName

string

否

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

cloud_ssdSystem
SystemDisk.Description

string

否

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

Test system disk.
SystemDisk.AutoSnapshotPolicyId

string

否

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

sp-bp12m37ccmxvbmi5****
SystemDisk.PerformanceLevel

string

否

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

  • PL0：单盘最高随机读写 IOPS 1 万。

  • PL1：单盘最高随机读写 IOPS 5 万。

  • PL2：单盘最高随机读写 IOPS 10 万。

  • PL3：单盘最高随机读写 IOPS 100 万。

说明

关于如何选择 ESSD 云盘性能等级，请参见 ESSD 云盘。

PL0
LoadBalancerWeight

integer

否

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

50
UserData

string

否

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

ZWNobyBoZWxsbyBlY3Mh
KeyPairName

string

否

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

  • 对 Windows 实例，该参数将被忽略，默认为空。

  • 对 Linux 实例，密码登录方式会被初始化成禁止。

KeyPair_Name
RamRoleName

string

否

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

RamRoleTest
PasswordInherit

boolean

否

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

false
Tags

string

否

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

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

  • Value 最多支持 128 个字符，不能以aliyun和acs:开头，不能包含http://或者https://。Value 可以为空字符串。

{"key1":"value1","key2":"value2", ... "key5":"value5"}
DeploymentSetId

string

否

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

ds-bp13v7bjnj9gis****
SecurityGroupId

string

否

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

sg-F876F****
Override

boolean

否

是否覆盖。可能值：

  • true：覆盖。

  • false：不覆盖。

true
ResourceGroupId

string

否

ECS 实例所属资源组的 ID。

abcd1234abcd****
HpcClusterId

string

否

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

hpc-clusterid
InstanceDescription

string

否

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

Test instance.
Ipv6AddressCount

integer

否

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

1
CreditSpecification

string

否

修改突发性能实例的运行模式。可能值：

Standard
ImageFamily

string

否

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

hangzhou-daily-update
ZoneId

string

否

ECS 实例所属的可用区 ID。

cn-hangzhou-g
DedicatedHostId

string

否

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

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

dh-bp67acfmxazb4p****
Affinity

string

否

专有宿主机实例是否与专有宿主机关联。可能值：

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

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

default
Tenancy

string

否

是否在专有宿主机上创建实例。可能值：

  • default：创建非专有宿主机实例。

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

default
SchedulerOptions

object

否

调度选项。

["testManagedPrivateSpaceId****"]
PrivatePoolOptions.MatchCriteria

string

否

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

  • Open：开放模式。将自动匹配开放类型的私有池容量。如果没有符合条件的私有池容量，则使用公共池资源启动。该模式下无需设置 PrivatePoolOptions.Id 参数。

  • Target：指定模式。使用指定的私有池容量启动实例，如果该私有池容量不可用，则实例会启动失败。该模式下必须指定私有池 ID，即 PrivatePoolOptions.Id 参数为必填项。

  • None：不使用模式。实例启动将不使用私有池容量。

Open
PrivatePoolOptions.Id

string

否

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

eap-bp67acfmxazb4****
SpotDuration

integer

否

抢占式实例的保留时长，单位为小时。可能值：

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

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

说明

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

默认值：1。

1
SpotInterruptionBehavior

string

否

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

Terminate
DataDisks

array<object>

否

数据盘信息的集合。

object

否

数据盘信息的集合。

PerformanceLevel

string

否

当数据盘为 ESSD 云盘时，设置云盘的性能等级。可能值：

  • PL0：单盘最高随机读写 IOPS 1 万。

  • PL1：单盘最高随机读写 IOPS 5 万。

  • PL2：单盘最高随机读写 IOPS 10 万。

  • PL3：单盘最高随机读写 IOPS 100 万。

说明

关于如何选择 ESSD 云盘性能等级，请参见 ESSD 云盘。

PL1
AutoSnapshotPolicyId

string

否

数据盘使用的自动快照策略 ID。

sp-bp19nq9enxqkomib****
Encrypted

string

否

是否加密系统盘。可能值：

  • true：加密。

  • false：不加密。

false
Description

string

否

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

Test data disk.

SnapshotId

string

否

创建数据盘时使用的快照。指定该参数后，DataDisk.Size 会被忽略，实际创建的磁盘大小为指定快照的大小。

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

s-snapshot****

Categories

array

否

数据盘的多磁盘类型。可能值：

  • cloud：普通云盘。随实例创建的普通云盘的 DeleteWithInstance 属性为 true。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

说明

指定本参数时，不允许同时指定DataDisk.Category。

string

否

数据盘的多磁盘类型。当无法使用高优先级的磁盘类型时，弹性伸缩自动尝试下一优先级的磁盘类型创建数据盘。可能值：

  • cloud：普通云盘。随实例创建的普通云盘的 DeleteWithInstance 属性为 true。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

说明

指定本参数时，不允许同时指定DataDisk.Category。

cloud
Size

integer

否

数据盘的磁盘大小，内存单位为 GiB。取值范围：

  • cloud：5~2000。

  • cloud_efficiency：20~32768。

  • cloud_ssd：20~32768。

  • cloud_essd：20~32768。

  • ephemeral_ssd：5~800。

指定该参数后，磁盘大小必须大于等于快照大小（快照通过 SnapshotId 指定）。

100
Device

string

否

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

/dev/xvdd
DiskName

string

否

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

cloud_ssdData

Category

string

否

数据盘的磁盘种类。可能值：

  • cloud：普通云盘。随实例创建的普通云盘的 DeleteWithInstance 属性为 true。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • ephemeral_ssd：本地 SSD 盘。

  • cloud_essd：ESSD 云盘。

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

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

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

cloud_ssd
DeleteWithInstance

boolean

否

指定数据盘是否随实例释放。可能值：

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

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

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

true
KMSKeyId

string

否

数据盘对应的 KMS 密钥的 ID。

0e478b7a-4262-4802-b8cb-00d3fb40****
ProvisionedIops

integer

否

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

说明

IOPS（Input/Output Operations Per Second）指每秒能处理的 I/O 个数，表示块存储处理读写（输出/输入）的能力，单位为次。

100
BurstingEnabled

boolean

否

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

  • true：开启。

  • false：未开启。

说明

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

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

false
SpotPriceLimits

array<object>

否

抢占实例规格的相关信息。

object

否

抢占实例规格的相关信息。

PriceLimit

number

否

抢占式实例对应的出价。SpotStrategy 取值为 SpotWithPriceLimit 时生效。

0.125

InstanceType

string

否

抢占式实例的实例规格。SpotStrategy 取值为 SpotWithPriceLimit 时生效。

ecs.g6.large

InstanceTypes

array

否

多实例规格参数。如果使用了 InstanceTypes，InstanceType 将被忽略。

当无法根据优先级较高的实例规格创建出实例时，弹性伸缩服务会自动选择下一优先级的实例规格来创建实例。

string

否

多实例规格参数。如果使用了 InstanceTypes，InstanceType 将被忽略。

当无法根据优先级较高的实例规格创建出实例时，弹性伸缩服务会自动选择下一优先级的实例规格来创建实例。

ecs.g6.large
InstanceTypeOverrides

array<object>

否

用于指定的实例规格相关信息。

object

否

用于指定的实例规格相关信息。

InstanceType

string

否

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

本参数用于指定实例规格。您可以指定多个本参数，结合 InstanceTypeOverride.WeightedCapacity 参数，扩展多实例规格支持自定义权重。

说明

指定本参数时，不允许同时指定 instanceTypes。

InstanceType 的取值范围：在售的 ECS 实例规格。

ecs.c5.xlarge

WeightedCapacity

integer

否

当您需要伸缩组按照实例规格容量进行伸缩时，在指定 LaunchTemplateOverride.InstanceType 后，再指定本参数。

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

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

例如：

  • 当前容量：0。

  • 期望容量：6。

  • ecs.c5.xlarge 规格容量：4。

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

说明

扩容时伸缩组的容量不得超过最大容量（MaxSize）与实例规格的最大权重之和。

WeightedCapacity 的取值范围：1~500。

4
SecurityGroupIds

array

否

所属安全组 ID。

string

否

所属安全组 ID。

sg-bp18kz60mefs****

InstancePatternInfos

array<object>

否

智能配置的信息集合，用于筛选符合要求的实例规格范围。

object

否

智能配置的信息集合，用于筛选符合要求的实例规格范围。

Cores

integer

否

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

请注意以下信息：

  • InstancePatternInfo 参数仅适用于伸缩组的网络类型为专有网络。

  • InstancePatternInfo 参数必须同时配置 InstancePatternInfo.Cores 和 InstancePatternInfo.Memory。

  • 如果您已经通过 InstanceType 或 InstanceTypes 参数指定了实例规格，弹性伸缩优先使用您指定的实例规格扩容，当指定的实例规格无库存时，再从符合 InstancePatternInfo 参数值的实例规格中优先使用价格最低的实例规格扩容。

2
InstanceFamilyLevel

string

否

实例规格族级别，用于筛选符合要求的实例规格范围，当CostOptimization开启时生效。可能值：

  • EntryLevel：入门级，即共享型实例规格。成本更低，但是无法保证实例计算性能的稳定。适用于平时 CPU 使用率低的业务场景。更多信息，请参见共享型。

  • EnterpriseLevel：企业级。性能稳定且资源独享，适用于对稳定性要求高的业务场景。更多信息，请参见实例规格族。

  • CreditEntryLevel：积分入门级，即突发性能实例。通过 CPU 积分来保证计算性能，适用于平时 CPU 使用率低、偶有突发 CPU 使用率的业务场景。更多信息，请参见突发性能实例概述。

EnterpriseLevel
MaxPrice

number

否

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

说明

SpotStrategy 设置为 SpotWithPriceLimit 时，该参数必选。其他情况下，该参数可选。

2
Memory

number

否

智能配置模式下，实例规格的内存大小，单位为 GiB，用于筛选符合要求的实例规格范围。

4
Architectures

array

否

实例规格所属的架构类型。可能值：

  • X86：X86 计算。

  • Heterogeneous：异构计算，例如 GPU 或 FPGA 等。

  • BareMental：弹性裸金属服务器。

  • Arm：Arm 计算。

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

string

否

实例规格所属的架构类型。可能值：

  • X86：X86 计算。

  • Heterogeneous：异构计算，例如 GPU 或 FPGA 等。

  • BareMental：弹性裸金属服务器。

  • Arm：Arm 计算。

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

X86
BurstablePerformance

string

否

是否为性能突发实例规格。可能值：

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

  • Include：包含性能突发实例规格。

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

默认值：Include。

Include
ExcludedInstanceTypes

array

否

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

  • ecs.c6.large：表示排除 ecs.c6.large 实例规格。

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

string

否

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

  • ecs.c6.large：表示排除 ecs.c6.large 实例规格。

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

ecs.n1.small/ecs.n1.*/*7*
InstanceTypeFamilies

array

否

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

string

否

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

ecs.g6
MinimumCpuCoreCount

integer

否

实例的最小 vCPU 内核数目。

2
MaximumCpuCoreCount

integer

否

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

说明

MaximumCpuCoreCount 不支持超过 MinimumCpuCoreCount 的 4 倍。

4
GpuSpecs

array

否

GPU 类型。

string

否

GPU 类型。

NVIDIA V100
InstanceCategories

array

否

实例规格分类。可能值：

  • 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 ：弹性裸金属服务器。

  • High Performance Compute：高性能计算型。

string

否

实例规格分类。可能值：

  • 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 ：弹性裸金属服务器。

  • High Performance Compute：高性能计算型。

Compute-optimized with GPU
CpuArchitectures

array

否

实例的 CPU 架构。可能值：

说明

N 表示可以设置多个 CPU 架构，N 的取值范围：1~2。

  • X86。

  • ARM。

string

否

实例规格的 CPU 架构。可能值：

说明

N 表示可以设置多个 CPU 架构，N 的取值范围：1~2。

  • X86。

  • ARM。

X86
PhysicalProcessorModels

array

否

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

string

否

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

Intel Xeon(Ice Lake) Platinum 8369B
MinimumEniQuantity

integer

否

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

2
MinimumEniPrivateIpAddressQuantity

integer

否

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

2
MinimumEniIpv6AddressQuantity

integer

否

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

1
MinimumInitialCredit

integer

否

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

12
MinimumBaselineCredit

integer

否

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

12
MinimumMemorySize

number

否

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

4
MaximumMemorySize

number

否

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

4
MinimumGpuAmount

integer

否

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

2
MaximumGpuAmount

integer

否

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

2
SystemDiskCategories

array

否

系统盘的多磁盘类型。当无法使用高优先级的磁盘类型时，弹性伸缩自动尝试下一优先级的磁盘类型创建系统盘。可能值：

  • cloud：普通云盘。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

说明

指定本参数时，不允许同时指定SystemDisk.Category。

string

否

系统盘的多磁盘类型。当无法使用高优先级的磁盘类型时，弹性伸缩自动尝试下一优先级的磁盘类型创建系统盘。可能值：

  • cloud：普通云盘。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

说明

指定本参数时，不允许同时指定SystemDisk.Category。

cloud
Password

string

否

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

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

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

说明

如果传入 Password 参数，建议您使用 HTTPS 协议发送请求，避免密码泄露。

123abc****
SystemDisk.Encrypted

boolean

否

是否加密系统盘。可能值：

  • true：加密。

  • false：不加密。

默认值：false。

false
SystemDisk.KMSKeyId

string

否

系统盘使用的 KMS 密钥 ID。

0e478b7a-4262-4802-b8cb-00d3fb40****
SystemDisk.EncryptAlgorithm

string

否

系统盘采用的加密算法。可能值：

  • AES-256。

  • SM4-128。

默认值：AES-256。

AES-256
SystemDisk.ProvisionedIops

integer

否

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

说明

IOPS（Input/Output Operations Per Second）指每秒能处理的 I/O 个数，表示块存储处理读写（输出/输入）的能力，单位为次。

100
SystemDisk.BurstingEnabled

boolean

否

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

  • true：开启。

  • false：未开启。

说明

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

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

false
ImageOptions.LoginAsNonRoot

boolean

否

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

true：是。

false：否。

false
DeletionProtection

boolean

否

实例释放保护属性，指定是否支持通过 ECS 控制台或 API（DeleteInstance）直接释放实例，防止实例被误删除。可能值：

  • true：开启实例释放保护，无法通过 ECS 控制台或 API（DeleteInstance）直接释放实例。

  • false：关闭实例释放保护，可以通过 ECS 控制台或 API（DeleteInstance）直接释放实例。

说明

该属性仅适用于按量付费实例，防止弹性伸缩扩容的实例被误删除，不影响正常的缩容活动，开启实例释放保护的实例可以被缩容活动释放掉。

false
StorageSetId

string

否

存储集 ID。

ss-bp67acfmxazb4p****
StorageSetPartitionNumber

integer

否

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

2
CustomPriorities

array<object>

否

ECS 实例规格+交换机的自定义优先级。

重要 仅在伸缩组的扩缩容策略为优先级策略时有效。

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

说明

如果仅指定了部分实例规格+交换机的自定义优先级，则未指定的部分优先级低于指定的部分，且未指定部分仍会依次按照伸缩组的交换机顺序、伸缩配置的实例规格顺序确定优先级。

  • 例如：伸缩组的交换机顺序为 vsw1、vsw2，伸缩配置的实例规格顺序为 type1、type2，自定义优先级顺序为["vsw2+type2", "vsw1+type2"]，则最终优先级为："vsw2+type2" > "vsw1+type2" > "vsw1+type1" > "vsw2+type1"

object

否

InstanceType

string

否

ECS 实例的实例规格。

说明

必须包含在伸缩配置的实例规格列表中。

ecs.c6a.4xlarge
VswitchId

string

否

虚拟交换机的 ID。

说明

必须包含在伸缩组的交换机列表中。

vsw-bp14zolna43z266bq****
NetworkInterfaces

array<object>

否

弹性网卡列表。

object

否

弹性网卡。

InstanceType

string

否

弹性网卡类型。使用此参数时，必须使用 NetworkInterfaces 设置主网卡，同时不能设置 SecurityGroupId 或 SecurityGroupIds 参数。可能值：

  • Primary：主网卡。

  • Secondary：辅助网卡。

默认值：Secondary。

Primary
NetworkInterfaceTrafficMode

string

否

网卡的通讯模式。可能值：

  • Standard：使用 TCP 通讯模式。

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

默认值：Standard。

说明

RDMA 模式的弹性网卡数量不能超过该实例规格族的限制。更多信息，请参见实例规格族。

HighPerformance
Ipv6AddressCount

integer

否

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

NetworkInterface.InstanceType 取值为 Primary 时，设置该参数才会生效。如果 NetworkInterface.InstanceType 取值为 Secondary 或空值，则不能设置该参数。

设置该参数后，您不能再设置 Ipv6AddressCount。

1
SecurityGroupIds

array

否

弹性网卡所属的一个或多个安全组 ID。

string

否

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

  • 如果 NetworkInterface.InstanceType 取值为 Primary，则必须设置该参数。此时该参数的作用等同于 SecurityGroupIds，但需要注意不能再设置 SecurityGroupId、SecurityGroupIds。

  • 如果 NetworkInterface.InstanceType 取值为 Secondary 或空值，则该参数为非必填参数。默认值为 ECS 实例所属的安全组，即主网卡的安全组。

sg-2ze55shrxxxxx
SecondaryPrivateIpAddressCount

integer

否

为网卡指定辅助私网 IPv4 地址数量。取值范围：1~49。

  • 取值不能超过该实例规格对于 ip 数量的限制。更多信息，请参见实例规格族。

  • NetworkInterface.N.SecondaryPrivateIpAddressCount 用于为网卡分配辅助私网 IPv4 地址数量（不包含该网卡的主私网 IP），系统将从该网卡所在虚拟交换机（NetworkInterface.N.VSwitchId）的可用网段中随机分配。

6
DedicatedHostClusterId

string

否

专有宿主机集群 ID。

dc-zm04u8r3lohsq****
SecurityOptions

object

否

安全选项。

ConfidentialComputingMode

string

否

机密计算模式。可能值：

TDX
HttpEndpoint

string

否

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

  • enabled：启用。

  • disabled：禁用。

默认值：enabled。

说明

有关实例元数据的信息，请参见实例元数据概述。

enabled
HttpTokens

string

否

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

  • optional：不强制使用。

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

默认值：optional。

说明

有关访问实例元数据的模式，请参见实例元数据访问模式。

optional
InternetMaxBandwidthIn

integer

否

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

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

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

10
ResourcePoolOptions

object

否

创建实例时使用的资源池策略。当您设置该参数后，需要注意：

  • 该参数只在创建按量付费实例时生效。

  • 该参数不能与 PrivatePoolOptions.MatchCriteria、PrivatePoolOptions.Id 同时设置。

Strategy

string

否

资源池包括弹性保障服务或容量预定服务生效后生成的私有池以及公共池，供实例启动时选择。取值范围：

  • PrivatePoolFirst：私有池优先。选择此种策略时，当指定了 ResourcePoolOptions.PrivatePoolIds 或满足 PrivatePoolTags 条件，优先使用对应的私有池。如果未指定私有池或指定的私有池容量不足，将自动匹配开放类型的私有池。如果没有符合条件的私有池，则使用公共池创建实例。

  • PrivatePoolOnly：仅限私有池。选择此种策略时，必须指定 ResourcePoolOptions.PrivatePoolIds。如果指定的私有池容量不足，则实例会启动失败。

  • PublicPoolFirst：公有池资源优先。优先使用公共池创建实例，当公有池资源不足时，采用私有池资源进行补充。优先自动匹配开放类型的私有池，如果没有符合条件的私有池，则使用指定的 ResourcePoolOptions.PrivatePoolIds 或满足 PrivatePoolTags 条件的 Target 类型私有池。（该策略正在邀测中，暂不支持使用。）

  • None：不使用资源池策略。

默认值：None。

PrivatePoolFirst
PrivatePoolIds

array

否

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID。该参数只能传入 Target 模式私有池 ID 且与 PrivatePoolTags 参数不能同时指定。

string

否

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID。该参数只能传入 Target 模式私有池 ID 且与 PrivatePoolTags 参数不能同时指定。N 的取值范围：1~20。

eap-bp67acfmxazb4****
PrivatePoolTags

array<object>

否

按标签筛选可用的 Target 私有池。N 的取值范围：1~20。 说明：

  • 当配置该参数时，系统仅从账号下已关联的 Target 私有池中，筛选出标签匹配且同时满足伸缩组约束（如可用区、实例规格等）的私有池。

  • 标签匹配规则：私有池需匹配所有传入标签。

  • 该参数与 PrivatePoolIds 参数不能同时指定。

object

否

按标签筛选可用的 Target 私有池。N 的取值范围：1~20。 说明：

  • 当配置该参数时，系统仅从账号下已关联的 Target 私有池中，筛选出标签匹配且同时满足伸缩组约束（如可用区、实例规格等）的私有池。

  • 标签匹配规则：私有池需匹配所有传入标签。

  • 该参数与 PrivatePoolIds 参数不能同时指定。

Key

string

否

私有池的标签键。

TestKey
Value

string

否

私有池的标签值。

TestValue
InstanceTypeCandidateOptions

object

否

设置备选模式后，当遇到库存不足等问题时，会根据当前已选的实例规格补充相同大小的近似规格，或者创建备选可用区的交换机并添加到伸缩组。

Enabled

boolean

否

是否开启备选模式

true
MaxPrice

number

否

备选实例规格的价格上限。

1.5
AllowDifferentGeneration

boolean

否

是否允许补充其他代系的实例规格。

  • 例如当前规格为 ecs.c7.large，开启后可备选 ecs.c6.large 和 ecs.c8.large 等规格。

true
AllowCrossAz

boolean

否

是否允许补充其他可用区的交换机。

说明

规格不变，仅备选新的可用区。当伸缩组由于库存等问题导致所有已选可用区均无法扩容时，会根据此配置自动增加新的可用区交换机到伸缩组中。 例如，伸缩组配置了 cn-hangzhou-h 和 cn-hangzhou-g 可用区，当两个可用区均无法扩容时 ESS 可能会根据实时库存状况创建一个 cn-hangzhou-k 的交换机并添加到伸缩组中。

true
AllowCidrBlocks

array

否

允许补充其他可用区交换机时，需要指定可选的交换机的网段。

string

否

允许补充其他可用区交换机时，需要指定可选的交换机的网段。

172.16.0.0/24

返回参数

名称

类型

描述

示例值

object

修改伸缩配置后的返回信息。

RequestId

string

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。

上一篇：DescribeScalingConfigurations - 查询ECS类型伸缩配置信息下一篇：DeleteScalingConfiguration - 删除一个ECS类型伸缩配置