AI 助理
文档备案控制台
官方文档
首页 弹性伸缩 开发参考 API参考 API参考（2014-08-28） API目录 伸缩配置 DescribeScalingConfigurations - 查询ECS类型伸缩配置信息

DescribeScalingConfigurations - 查询ECS类型伸缩配置信息

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

调用API DescribeScalingConfigurations查询ECS类型伸缩配置的信息，包括实例规格、镜像等信息，方便您提前了解弹性扩张时使用的ECS实例模板详情。

调试

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

调试

授权信息

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

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

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

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ess:DescribeScalingConfigurations

get

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
RegionId

string

是

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

cn-qingdao
PageNumber

integer

否

伸缩配置列表的页码，起始值：1。

默认值：1。

1
PageSize

integer

否

分页查询时设置的每页行数，最大值：50。

默认值：10。

50
ScalingGroupId

string

否

伸缩组的 ID，您可以查询该伸缩组下所有的伸缩配置。

asg-bp17pelvl720x3v7****
ScalingConfigurationId

array

否

待查询伸缩配置的 ID。

查询结果包括生效和未生效的伸缩配置，并通过返回参数LifecycleState进行标识。

asc-bp17pelvl720x5ub****

string

否

待查询伸缩配置的 ID。

查询结果包括生效和未生效的伸缩配置，并通过返回参数LifecycleState进行标识。

asc-bp17pelvl720x5ub****
ScalingConfigurationName

array

否

待查询伸缩配置的名称。

查询结果会忽略失效的伸缩配置名称，并且不报错。

scalingcon****

string

否

待查询伸缩配置的名称。

查询结果会忽略失效的伸缩配置名称，并且不报错。

scalingcon****

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

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

integer

当前页码。

1
PageSize

integer

每页行数。

50
TotalCount

integer

伸缩配置的总数。

1
ScalingConfigurations

object

ScalingConfiguration

array<object>

伸缩配置信息的集合。

array<object>

伸缩配置信息的集合。

DeploymentSetId

string

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

ds-bp1frxuzdg87zh4p****
CreationTime

string

伸缩配置的创建时间。

2014-08-14T10:58Z
ScalingConfigurationName

string

伸缩配置的名称。

scalingconfigura****
SystemDiskDescription

string

系统盘的描述。

Test system disk.
KeyPairName

string

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

keypair****
SecurityGroupId

string

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

sg-bp18kz60mefs****
PrivatePoolOptions.Id

string

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

eap-bp67acfmxazb4****
SystemDiskAutoSnapshotPolicyId

string

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

sp-bp12m37ccmxvbmi5****
SpotStrategy

string

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

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

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

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

NoSpot
ScalingGroupId

string

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

asg-bp17pelvl720x3v7****
Affinity

string

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

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

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

default
Tenancy

string

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

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

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

default
SystemDiskSize

integer

系统盘的磁盘大小。单位为 GiB。

100
Ipv6AddressCount

integer

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

1
SpotDuration

integer

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

1
LifecycleState

string

伸缩配置在伸缩组中的状态。可能值：

  • Active：生效状态。伸缩组会使用处于生效状态的伸缩配置自动创建 ECS 实例。

  • Inacitve：未生效状态。处于未生效状态的伸缩配置存在于伸缩组中，但伸缩组不会使用此类伸缩配置自动创建 ECS 实例。

Active
InstanceName

string

ECS 实例的名称。

instance****
SecurityEnhancementStrategy

string

是否开启安全加固。可能值：

  • Active：启用安全加固，只对公共镜像生效。

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

Active
UserData

string

ECS 实例的自定义数据，以 Base64 方式编码。

echo hello ecs!
PrivatePoolOptions.MatchCriteria

string

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

  • Open：开放模式。将自动匹配开放类型的私有池容量。如果没有符合条件的私有池容量，则使用公共池资源启动。

  • Target：指定模式。使用指定的私有池容量启动实例，如果该私有池容量不可用，则实例会启动失败。

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

Open
DedicatedHostId

string

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

您可以通过 DescribeDedicatedHosts 查询专有宿主机 ID 列表。

dh-bp67acfmxazb4p****
InstanceGeneration

string

ECS 实例的系列。

ecs-3
HpcClusterId

string

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

hpc-clus****
PasswordInherit

boolean

是否使用镜像预设的密码。

true
Memory

integer

内存大小，单位为 GiB。

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

说明

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

16
ImageId

string

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

centos6u5_64_20G_aliaegis_2014****.vhd
ImageFamily

string

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

hangzhou-daily-update
ImageOwnerAlias

string

镜像来源。可能值：

  • system：阿里云提供的公共镜像。

  • self：您创建的自定义镜像。

  • others：其他阿里云用户提供的共享镜像或社区镜像。

  • marketplace：云市场镜像提供的镜像。

system
LoadBalancerWeight

integer

ECS 实例作为后端服务器时的权重。可能值：1~100。

1
SystemDiskCategory

string

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

  • cloud：普通云盘。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • ephemeral_ssd：本地 SSD 盘。

  • cloud_essd：ESSD 云盘。

  • cloud_auto：ESSD AutoPL 云盘。

cloud
HostName

string

云服务器的主机名。

LocalHost
SystemDiskName

string

系统盘的名称。

cloud_ssd_Test
InternetMaxBandwidthOut

integer

公网出带宽最大值，单位为 Mbit/s。

10
InternetMaxBandwidthIn

integer

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

10
InstanceType

string

ECS 实例的实例规格。

ecs.g6.large
InstanceDescription

string

ECS 实例的描述。

FinanceDept
IoOptimized

string

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

  • none：非 I/O 优化。

  • optimized：I/O 优化。

none
RamRoleName

string

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

ramrole****
SystemDiskPerformanceLevel

string

当系统盘为 ESSD 云盘时，ESSD 云盘的性能等级。

PL1
Cpu

integer

vCPU 个数。

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

说明

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

2
ResourceGroupId

string

ECS 实例所属资源组的 ID。

rg-aekzn2ou7xo****
ZoneId

string

实例所属的可用区 ID，您可以调用 DescribeZones 获取可用区列表。

cn-hangzhou-g
InternetChargeType

string

网络计费类型。可能值：

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

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

PayByTraffic
ImageName

string

镜像文件名称。

centos6u5_64_20G_aliaegis_20140703.vhd
ScalingConfigurationId

string

伸缩配置的 ID。

asc-bp1ezrfgoyn5kijl****
CreditSpecification

string

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

Standard
SpotInterruptionBehavior

string

抢占实例中断模式。

Terminate
DataDisks

object

DataDisk

array<object>

数据盘信息的集合。

array<object>

数据盘信息的集合。

PerformanceLevel

string

当数据盘为 ESSD 云盘时，ESSD 云盘的性能等级。

PL1
Description

string

数据盘的描述。

FinanceDept
SnapshotId

string

创建数据盘使用的快照 ID。

s-23f2i****
Device

string

数据盘的挂载点。

/dev/xvdb
Size

integer

数据盘的磁盘大小，内存单位为 GiB。可能值：

  • cloud：5~2000。

  • cloud_efficiency：20~32768。

  • cloud_ssd：20~32768。

  • cloud_essd：20~32768。

  • ephemeral_ssd：5~800。

200
DiskName

string

数据盘的名称。

cloud_ssdData
AutoSnapshotPolicyId

string

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

sp-bp19nq9enxqkomib****
Category

string

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

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

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

  • ephemeral_ssd：本地 SSD 盘。

  • cloud_auto：ESSD AutoPL 云盘。

  • cloud_regional_disk_auto：ESSD 同城冗余云盘。

cloud
KMSKeyId

string

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

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

boolean

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

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

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

true
Encrypted

string

数据盘是否加密。可能值：

  • true：加密。

  • false：不加密。

false
Categories

object

Category

array

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

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

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

  • ephemeral_ssd：本地 SSD 盘。

  • cloud_auto：ESSD AutoPL 云盘。

  • cloud_regional_disk_auto：ESSD 同城冗余云盘。

string

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

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

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

cloud_essd
ProvisionedIops

integer

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

说明

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

100
BurstingEnabled

boolean

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

  • true：开启。

  • false：未开启。

说明

当DataDisk.Category取值为cloud_auto时才显示该参数。

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

false
Tags

object

Tag

array<object>

标签信息的集合。

object

标签信息的集合。

Key

string

实例的标签键。N 的取值范围：1~20。

如果传入该值，则不允许为空字符串。最多支持 128 个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

binary
Value

string

实例的标签值。N 的取值范围：1~20。

如果传入该值，则允许为空字符串。最多支持 128 个字符，不能以acs:开头，不能包含http://或者https://。

alterTable
SpotPriceLimit

object

SpotPriceModel

array<object>

抢占式实例信息的集合。

object

抢占式实例信息的集合。

InstanceType

string

抢占式实例的实例规格。

ecs.g6.large
PriceLimit

number

抢占式实例对应的出价。

0.125
InstancePatternInfos

object

InstancePatternInfo

array<object>

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

array<object>

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

MaxPrice

number

按量付费实例或者抢占式实例可接受的每小时最高价格。

2
Cores

integer

实例规格的 vCPU 内核数目。

2
Memory

number

实例规格的内存大小，单位为 GiB。

4
InstanceFamilyLevel

string

实例规格族级别。

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

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

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

EnterpriseLevel
Architectures

object

Architecture

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

object

ExcludedInstanceType

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

object

InstanceTypeFamily

array

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

string

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

ecs.g6
MinimumCpuCoreCount

integer

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

2
MaximumCpuCoreCount

integer

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

说明

MaximumCpuCoreCount参数值不能超过MinimumCpuCoreCount参数值的 4 倍。

4
GpuSpecs

object

GpuSpec

array

GPU 类型。

string

GPU 类型。

NVIDIA V100
InstanceCategories

object

InstanceCategory

array

实例规格分类。

string

实例分类。取值范围：

说明

N 表示可以设置多个实例分类，N 的取值范围：1~10。

  • 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

object

CpuArchitecture

array

实例规格的 CPU 架构。

string

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

说明

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

  • X86。

  • ARM。

X86
PhysicalProcessorModels

object

PhysicalProcessorModel

array

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

string

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

Intel Xeon(Ice Lake) Platinum 8369B", "Intel Xeon(Skylake) Platinum 8163", … "Intel Xeon(Cascade Lake) Platinum 8269CY
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

object

SystemDiskCategory

array

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

  • cloud：普通云盘。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

string

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

  • cloud：普通云盘。

  • cloud_efficiency：高效云盘。

  • cloud_ssd：SSD 云盘。

  • cloud_essd：ESSD 云盘。

cloud
WeightedCapacities

object

WeightedCapacity

array

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

string

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

4
InstanceTypes

object

InstanceType

array

ECS 实例的实例规格的集合。

string

ECS 实例的实例规格的集合。

ecs.g6.large
SecurityGroupIds

object

SecurityGroupId

array

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

string

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

sg-bp18kz60mefs****
SchedulerOptions

object

调度选项。

ManagedPrivateSpaceId

string

智能全托管资源池。

testManagedPrivateSpaceId
SystemDisk.Encrypted

boolean

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

  • true：加密。

  • false：不加密。

false
SystemDisk.KMSKeyId

string

系统盘使用的 KMS 密钥 ID。

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

string

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

  • AES-256。

  • SM4-128。

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 用户登录。可能值：

  • true：是。

  • false：否。

false
DeletionProtection

boolean

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

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

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

说明

该属性不影响弹性伸缩正常的缩容活动，即弹性伸缩发生缩容活动时，开启实例释放保护的按量付费实例可以被正常释放掉。

false
StorageSetId

string

存储集 ID。

ss-bp67acfmxazb4p****
StorageSetPartitionNumber

integer

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

2
CustomPriorities

object

CustomPriority

array<object>

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

说明

该参数仅在伸缩组的扩缩容策略为优先级策略时有效。

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

说明

如果仅指定了部分 ECS 实例规格+虚拟交换机组合的自定义优先级，则未指定的组合优先级低于指定的组合优先级，且未指定的组合仍会依次按照伸缩组的虚拟交换机顺序、伸缩配置的实例规格顺序确定优先级。例如：伸缩组的虚拟交换机顺序依次为 vsw1、vsw2，伸缩配置的实例规格顺序依次为 type1、type2，该组合的自定义优先级顺序为["vsw2+type2", "vsw1+type2"]，则最终优先级为vsw2+type2> vsw1+type2 > vsw1+type1 > vsw2+type1。

object

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

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

InstanceType

string

ECS 实例的实例规格。

说明

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

ecs.g6.large
VswitchId

string

虚拟交换机的 ID。

说明

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

vsw-bp14zolna43z266bq****
NetworkInterfaces

object

NetworkInterface

array<object>

弹性网卡列表。

array<object>

弹性网卡列表。

InstanceType

string

弹性网卡类型。可能值：

  • Primary：主网卡。

  • Secondary：辅助弹性网卡。

Primary
NetworkInterfaceTrafficMode

string

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

  • Standard：使用 TCP 通讯模式。

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

HighPerformance
Ipv6AddressCount

integer

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

1
SecurityGroupIds

object

SecurityGroupId

array

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

string

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

sg-2vc3e1v7h****
SecondaryPrivateIpAddressCount

integer

为网卡指定辅助私网 IPv4 地址数量。可能值：1~49。

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

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

2
VSwitchIds

object

VSwitchId

array

弹性网卡所属的虚拟交换机 ID。

string

弹性网卡所属的虚拟交换机 ID。

vsw-bp67acfmxazb4p****
DedicatedHostClusterId

string

专有宿主机集群 ID。

dc-2zedxc67zqzt7lb4****
PasswordSetted

boolean

是否设置实例密码。可能值：

  • true：设置实例密码

  • false：不设置实例密码

false
SecurityOptions

object

安全选项。

ConfidentialComputingMode

string

机密计算模式。可能值：

TDX
HttpEndpoint

string

是否启用实例元数据的访问通道。可能值：

  • enabled：启用。

  • disabled：禁用。

enabled
HttpTokens

string

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

  • optional：不强制使用。

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

optional
ResourcePoolOptions

object

创建实例时使用的资源池策略。

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

Strategy

string

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

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

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

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

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

默认值：None。

PrivatePoolFirst
PrivatePoolIds

object

PrivatePoolId

array

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID 且与 PrivatePoolTags 参数不能同时指定。

string

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID 且与 PrivatePoolTags 参数不能同时指定。

eap-bp67acfmxazb4****
PrivatePoolTags

object

PrivatePoolTag

array<object>

按标签筛选可用的 Target 私有池。

object

按标签筛选可用的 Target 私有池。

Key

string

私有池的标签键。

可按标签筛选可用的 Target 私有池。

TestKey
Value

string

私有池的标签值。

TestValue
CpuOptions

object

CPU 选项。

NestedVirtualization

string

嵌套虚拟化，是否开启基于硬件实现的嵌套虚拟化功能。可能值：

  • enabled：开启。

  • disabled：不开启。

enabled
SecondaryEniVSwitchConstraint

string

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

Strict

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 1,
  "ScalingConfigurations": {
    "ScalingConfiguration": [
      {
        "DeploymentSetId": "ds-bp1frxuzdg87zh4p****",
        "CreationTime": "2014-08-14T10:58Z",
        "ScalingConfigurationName": "scalingconfigura****",
        "SystemDiskDescription": "Test system disk.",
        "KeyPairName": "keypair****",
        "SecurityGroupId": "sg-bp18kz60mefs****",
        "PrivatePoolOptions.Id": "eap-bp67acfmxazb4****",
        "SystemDiskAutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
        "SpotStrategy": "NoSpot",
        "ScalingGroupId": "asg-bp17pelvl720x3v7****",
        "Affinity": "default",
        "Tenancy": "default",
        "SystemDiskSize": 100,
        "Ipv6AddressCount": 1,
        "SpotDuration": 1,
        "LifecycleState": "Active",
        "InstanceName": "instance****",
        "SecurityEnhancementStrategy": "Active",
        "UserData": "echo hello ecs!",
        "PrivatePoolOptions.MatchCriteria": "Open",
        "DedicatedHostId": "dh-bp67acfmxazb4p****",
        "InstanceGeneration": "ecs-3",
        "HpcClusterId": "hpc-clus****",
        "PasswordInherit": true,
        "Memory": 16,
        "ImageId": "centos6u5_64_20G_aliaegis_2014****.vhd",
        "ImageFamily": "hangzhou-daily-update",
        "ImageOwnerAlias": "system",
        "LoadBalancerWeight": 1,
        "SystemDiskCategory": "cloud",
        "HostName": "LocalHost",
        "SystemDiskName": "cloud_ssd_Test",
        "InternetMaxBandwidthOut": 10,
        "InternetMaxBandwidthIn": 10,
        "InstanceType": "ecs.g6.large",
        "InstanceDescription": "FinanceDept",
        "IoOptimized": "none",
        "RamRoleName": "ramrole****",
        "SystemDiskPerformanceLevel": "PL1",
        "Cpu": 2,
        "ResourceGroupId": "rg-aekzn2ou7xo****",
        "ZoneId": "cn-hangzhou-g",
        "InternetChargeType": "PayByTraffic",
        "ImageName": "centos6u5_64_20G_aliaegis_20140703.vhd",
        "ScalingConfigurationId": "asc-bp1ezrfgoyn5kijl****",
        "CreditSpecification": "Standard",
        "SpotInterruptionBehavior": "Terminate",
        "DataDisks": {
          "DataDisk": [
            {
              "PerformanceLevel": "PL1",
              "Description": "FinanceDept",
              "SnapshotId": "s-23f2i****",
              "Device": "/dev/xvdb",
              "Size": 200,
              "DiskName": "cloud_ssdData",
              "AutoSnapshotPolicyId": "sp-bp19nq9enxqkomib****",
              "Category": "cloud",
              "KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****",
              "DeleteWithInstance": true,
              "Encrypted": "false",
              "Categories": {
                "Category": [
                  "cloud_essd"
                ]
              },
              "ProvisionedIops": 100,
              "BurstingEnabled": false
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "binary",
              "Value": "alterTable"
            }
          ]
        },
        "SpotPriceLimit": {
          "SpotPriceModel": [
            {
              "InstanceType": "ecs.g6.large",
              "PriceLimit": 0.125
            }
          ]
        },
        "InstancePatternInfos": {
          "InstancePatternInfo": [
            {
              "MaxPrice": 2,
              "Cores": 2,
              "Memory": 4,
              "InstanceFamilyLevel": "EnterpriseLevel",
              "Architectures": {
                "Architecture": [
                  "X86"
                ]
              },
              "BurstablePerformance": "Include",
              "ExcludedInstanceTypes": {
                "ExcludedInstanceType": [
                  "ecs.n1.small/ecs.n1.*/*7*"
                ]
              },
              "InstanceTypeFamilies": {
                "InstanceTypeFamily": [
                  "ecs.g6"
                ]
              },
              "MinimumCpuCoreCount": 2,
              "MaximumCpuCoreCount": 4,
              "GpuSpecs": {
                "GpuSpec": [
                  "NVIDIA V100"
                ]
              },
              "InstanceCategories": {
                "InstanceCategory": [
                  "Compute-optimized with GPU"
                ]
              },
              "CpuArchitectures": {
                "CpuArchitecture": [
                  "X86"
                ]
              },
              "PhysicalProcessorModels": {
                "PhysicalProcessorModel": [
                  "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,
              "MaximumMemorySize": 4,
              "MinimumGpuAmount": 2,
              "MaximumGpuAmount": 2
            }
          ]
        },
        "SystemDiskCategories": {
          "SystemDiskCategory": [
            "cloud"
          ]
        },
        "WeightedCapacities": {
          "WeightedCapacity": [
            "4"
          ]
        },
        "InstanceTypes": {
          "InstanceType": [
            "ecs.g6.large"
          ]
        },
        "SecurityGroupIds": {
          "SecurityGroupId": [
            "sg-bp18kz60mefs****"
          ]
        },
        "SchedulerOptions": {
          "ManagedPrivateSpaceId": "testManagedPrivateSpaceId"
        },
        "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": {
          "CustomPriority": [
            {
              "InstanceType": "ecs.g6.large",
              "VswitchId": "vsw-bp14zolna43z266bq****"
            }
          ]
        },
        "NetworkInterfaces": {
          "NetworkInterface": [
            {
              "InstanceType": "Primary",
              "NetworkInterfaceTrafficMode": "HighPerformance",
              "Ipv6AddressCount": 1,
              "SecurityGroupIds": {
                "SecurityGroupId": [
                  "sg-2vc3e1v7h****"
                ]
              },
              "SecondaryPrivateIpAddressCount": 2,
              "VSwitchIds": {
                "VSwitchId": [
                  "vsw-bp67acfmxazb4p****"
                ]
              }
            }
          ]
        },
        "DedicatedHostClusterId": "dc-2zedxc67zqzt7lb4****",
        "PasswordSetted": false,
        "SecurityOptions": {
          "ConfidentialComputingMode": "TDX"
        },
        "HttpEndpoint": "enabled",
        "HttpTokens": "optional",
        "ResourcePoolOptions": {
          "Strategy": "PrivatePoolFirst",
          "PrivatePoolIds": {
            "PrivatePoolId": [
              "eap-bp67acfmxazb4****"
            ]
          },
          "PrivatePoolTags": {
            "PrivatePoolTag": [
              {
                "Key": "TestKey",
                "Value": "TestValue"
              }
            ]
          }
        },
        "CpuOptions": {
          "NestedVirtualization": "enabled"
        },
        "SecondaryEniVSwitchConstraint": "Strict"
      }
    ]
  }
}

错误码

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

变更历史

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

上一篇：ModifyScalingConfiguration - 修改一个ECS类型伸缩配置下一篇：DeactivateScalingConfiguration - 使指定伸缩配置进入失效状态