全部产品
Search

搜索本产品

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

    文档中心

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

    更新时间：Jul 02, 2026

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

    调试

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

    调试

    授权信息

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

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

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

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ess:DescribeScalingConfigurations

    get

    *ScalingGroup

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

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

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

    cn-qingdao
    PageNumber

    integer

    否

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

    默认值：1。

    1
    PageSize

    integer

    否

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

    默认值：10。

    50
    ScalingGroupId

    string

    否

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

    asg-bp17pelvl720x3v7****
    ScalingConfigurationIds

    array

    否

    待查询伸缩配置的 ID。

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

    string

    否

    待查询伸缩配置的 ID。

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

    asc-bp17pelvl720x5ub****
    ScalingConfigurationNames

    array

    否

    待查询伸缩配置的名称。

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

    string

    否

    待查询伸缩配置的名称。

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

    scalingcon****

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

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

    integer

    当前页码。

    1
    PageSize

    integer

    每页行数。

    50
    TotalCount

    integer

    伸缩配置的总数。

    1
    ScalingConfigurations

    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。

    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 实例的自定义数据。

    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 角色。

    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_2014****.vhd

    ScalingConfigurationId

    string

    伸缩配置的 ID。

    asc-bp1ezrfgoyn5kijl****
    CreditSpecification

    string

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

    Standard
    SpotInterruptionBehavior

    string

    抢占实例中断模式。

    Terminate
    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****

    DataDisks

    array<object>

    数据盘信息的集合。

    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 云盘。

    • ephemeral_ssd：本地 SSD 盘。

    • cloud_essd：ESSD 云盘。

    • 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。

    false
    Categories

    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 云盘。

    • ephemeral_ssd：本地 SSD 盘。

    • cloud_auto：ESSD AutoPL 云盘。

    • cloud_regional_disk_auto：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时才显示该参数。

    false
    Tags

    array<object>

    标签信息的集合。

    object

    标签信息的集合。

    Key

    string

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

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

    binary
    Value

    string

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

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

    alterTable
    SpotPriceLimits

    array<object>

    抢占式实例信息的集合。

    object

    抢占式实例信息的集合。

    InstanceType

    string

    抢占式实例的实例规格。

    ecs.g6.large

    PriceLimit

    number

    抢占式实例对应的出价。

    0.125

    InstancePatternInfos

    array<object>

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

    object

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

    MaxPrice

    number

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

    2
    Cores

    integer

    实例规格的 vCPU 内核数目。

    2
    Memory

    number

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

    4
    InstanceFamilyLevel

    string

    实例规格族级别。

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

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

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

    EnterpriseLevel
    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
    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

    实例分类。可能值：

    说明

    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：高性能计算型。

    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

    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 云盘。

    string

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

    • cloud：普通云盘。

    • cloud_efficiency：高效云盘。

    • cloud_ssd：SSD 云盘。

    • cloud_essd：ESSD 云盘。

    cloud
    WeightedCapacities

    array

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

    integer

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

    4
    InstanceTypes

    array

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

    string

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

    ecs.g6.large
    SecurityGroupIds

    array

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

    string

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

    sg-bp18kz60mefs****
    SchedulerOptions

    object
    说明

    该参数正在邀测中，暂未开放使用。

    ManagedPrivateSpaceId

    string
    说明

    该参数正在邀测中，暂未开放使用。

    testManagedPrivateSpaceId
    SystemDiskEncrypted

    boolean

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

    • true：加密。

    • false：不加密。

    false
    SystemDiskKMSKeyId

    string

    系统盘使用的 KMS 密钥 ID。

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

    SystemDiskEncryptAlgorithm

    string

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

    • AES-256。

    • SM4-128。

    AES-256

    SystemDiskProvisionedIops

    integer

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

    说明

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

    100
    SystemDiskBurstingEnabled

    boolean

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

    • true：开启。

    • false：未开启。

    说明

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

    false
    ImageOptionsLoginAsNonRoot

    boolean

    ECS 实例是否使用 ecs-user 用户登录。可能值：

    • 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
    NetworkInterfaces

    array<object>

    弹性网卡列表。

    object

    弹性网卡。

    InstanceType

    string

    弹性网卡类型。可能值：

    • Primary：主网卡。

    • Secondary：辅助弹性网卡。

    Primary
    NetworkInterfaceTrafficMode

    string

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

    • Standard：使用 TCP 通讯模式。

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

    HighPerformance
    Ipv6AddressCount

    integer

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

    1
    SecurityGroupIds

    array

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

    string

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

    sg-2vc3e1v7xxxxx
    SecondaryPrivateIpAddressCount

    integer

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

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

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

    2
    DedicatedHostClusterId

    string

    专有宿主机集群 ID。

    dc-zm04u8r3lohsq****
    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：不使用资源池策略。

    PrivatePoolFirst
    PrivatePoolIds

    array

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

    string

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

    eap-bp67acfmxazb4****
    PrivatePoolTags

    array<object>

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

    object

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

    Key

    string

    私有池的标签键。

    TestKey
    Value

    string

    私有池的标签值。

    TestValue
    InstanceTypeCandidateOptions

    object

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

    Enabled

    boolean

    是否开启备选模式

    true
    MaxPrice

    number

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

    2
    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

    CpuOptions

    object

    CPU 选项。

    NestedVirtualization

    string

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

    • enabled（开启）

    • disabled（不开启）。

    enabled

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 1,
  "ScalingConfigurations": [
    {
      "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!\t\n",
      "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_2014****.vhd\t\n",
      "ScalingConfigurationId": "asc-bp1ezrfgoyn5kijl****",
      "CreditSpecification": "Standard",
      "SpotInterruptionBehavior": "Terminate",
      "CustomPriorities": [
        {
          "InstanceType": "ecs.c6a.4xlarge",
          "VswitchId": "vsw-bp14zolna43z266bq****\n"
        }
      ],
      "DataDisks": [
        {
          "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": [
            "cloud_essd"
          ],
          "ProvisionedIops": 100,
          "BurstingEnabled": false
        }
      ],
      "Tags": [
        {
          "Key": "binary",
          "Value": "alterTable"
        }
      ],
      "SpotPriceLimits": [
        {
          "InstanceType": "ecs.g6.large\t\n",
          "PriceLimit": 0.125
        }
      ],
      "InstancePatternInfos": [
        {
          "MaxPrice": 2,
          "Cores": 2,
          "Memory": 4,
          "InstanceFamilyLevel": "EnterpriseLevel",
          "Architectures": [
            "X86"
          ],
          "BurstablePerformance": "Include",
          "ExcludedInstanceTypes": [
            "ecs.n1.small/ecs.n1.*/*7*"
          ],
          "InstanceTypeFamilies": [
            "ecs.g6"
          ],
          "MinimumCpuCoreCount": 2,
          "MaximumCpuCoreCount": 4,
          "GpuSpecs": [
            "NVIDIA V100"
          ],
          "InstanceCategories": [
            "Compute-optimized with GPU"
          ],
          "CpuArchitectures": [
            "X86"
          ],
          "PhysicalProcessorModels": [
            "Intel Xeon(Ice Lake) Platinum 8369B"
          ],
          "MinimumEniQuantity": 2,
          "MinimumEniPrivateIpAddressQuantity": 2,
          "MinimumEniIpv6AddressQuantity": 1,
          "MinimumInitialCredit": 12,
          "MinimumBaselineCredit": 12,
          "MinimumMemorySize": 4,
          "MaximumMemorySize": 4,
          "MinimumGpuAmount": 2,
          "MaximumGpuAmount": 2
        }
      ],
      "SystemDiskCategories": [
        "cloud"
      ],
      "WeightedCapacities": [
        4
      ],
      "InstanceTypes": [
        "ecs.g6.large"
      ],
      "SecurityGroupIds": [
        "sg-bp18kz60mefs****"
      ],
      "SchedulerOptions": {
        "ManagedPrivateSpaceId": "testManagedPrivateSpaceId"
      },
      "SystemDiskEncrypted": false,
      "SystemDiskKMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****\t\n",
      "SystemDiskEncryptAlgorithm": "AES-256\t\n",
      "SystemDiskProvisionedIops": 100,
      "SystemDiskBurstingEnabled": false,
      "ImageOptionsLoginAsNonRoot": false,
      "DeletionProtection": false,
      "StorageSetId": "ss-bp67acfmxazb4p****",
      "StorageSetPartitionNumber": 2,
      "NetworkInterfaces": [
        {
          "InstanceType": "Primary",
          "NetworkInterfaceTrafficMode": "HighPerformance",
          "Ipv6AddressCount": 1,
          "SecurityGroupIds": [
            "sg-2vc3e1v7xxxxx"
          ],
          "SecondaryPrivateIpAddressCount": 2
        }
      ],
      "DedicatedHostClusterId": "dc-zm04u8r3lohsq****",
      "PasswordSetted": false,
      "SecurityOptions": {
        "ConfidentialComputingMode": "TDX"
      },
      "HttpEndpoint": "enabled",
      "HttpTokens": "optional",
      "ResourcePoolOptions": {
        "Strategy": "PrivatePoolFirst",
        "PrivatePoolIds": [
          "eap-bp67acfmxazb4****"
        ],
        "PrivatePoolTags": [
          {
            "Key": "TestKey",
            "Value": "TestValue"
          }
        ]
      },
      "InstanceTypeCandidateOptions": {
        "Enabled": true,
        "MaxPrice": 2,
        "AllowDifferentGeneration": true,
        "AllowCrossAz": true,
        "AllowCidrBlocks": [
          "172.16.0.0/24\n"
        ]
      },
      "CpuOptions": {
        "NestedVirtualization": "enabled"
      }
    }
  ]
}

    错误码

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

    变更历史

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