文档

SetAutoScaleConfig - 设置自动伸缩配置信息

更新时间:

调用SetAutoScaleConfig设置指定集群的自动伸缩配置信息。

接口说明

当队列配置和全局配置中配置不一致时,以队列设置为优先。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ehpc:SetAutoScaleConfigWrite
  • 全部资源
    *

请求参数

名称类型必填描述示例值
ClusterIdstring

集群 ID。

ehpc-hz-FYUr32****
EnableAutoGrowboolean

是否开启自动扩容。取值范围:

  • true:开启自动扩容
  • false:不开启自动扩容

默认值: false

false
EnableAutoShrinkboolean

是否开启自动缩容。取值范围:

  • true:开启自动缩容
  • false:不开启自动缩容

默认值: false

false
GrowIntervalInMinutesinteger

每轮计算节点扩容的时间间隔。单位:分钟

取值范围:2~10

默认值:2

说明 一次扩容任务可能会分几次完成,或者连续触发扩容时的时间间隔。
2
ShrinkIntervalInMinutesinteger

每轮计算节点收缩的时间间隔。单位:分钟

取值范围:2~10

默认值:2

2
ShrinkIdleTimesinteger

节点连续空闲(未运行作业)次数。节点收缩检查时,一个节点连续处于空闲状态的次数。

取值范围:2~5

默认值:3

如果设置为 3,表示一个计算节点连续空闲超过 3 次,就会被释放。因为 ShrinkIntervalInMinutes 默认值是 2 分钟,所以默认配置下,一个计算节点连续空闲时间超过 6 分钟,就会被释放。

3
GrowTimeoutInMinutesinteger

扩容超时时间。单位:分钟

取值范围:10~60

默认值:20

如果扩容时间大于扩容超时时间,节点依然未达到运行状态,该节点将被释放。

20
ExtraNodesGrowRatiointeger

额外节点百分比。取值范围:0~100

默认值:0

如果作业负载需要新增 100 个计算节点,ExtraNodesGrowRatio 值为 2,那么最终新增数量为 102。

0
GrowRatiointeger

扩容比例。取值范围:1~100

默认值:100

如果作业负载需要新增 10 个计算节点,GrowRatio 配置为 50,那么会进行多轮扩容,每轮扩容当前所需的 50%节点。

50
MaxNodesInClusterinteger

集群最多可以扩容的计算节点数量。取值范围:0~500

默认值:100

100
ExcludeNodesstring

例外节点列表,不参与自动伸缩的节点列表。节点之间用半角逗号(,)隔开。

如果您希望一直保留某个节点,可以设置为例外节点,空闲时不被释放。

i-bp19lgqwxb4206t5****,i-bp1g4hvzs9pywrhb****
SpotStrategystring

计算节点抢占策略。取值范围:

  • NoSpot:正常按量付费节点。
  • SpotWithPriceLimit:设置上限价格的抢占式节点。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的抢占式节点。

默认值:NoSpot

SpotWithPriceLimit
SpotPriceLimitfloat

设置节点的每小时最高价格,最多支持 3 位小数。参数SpotStrategy取值为SpotWithPriceLimit时生效。

0.062
ImageIdstring

镜像 ID。

说明
  • 如果同时设置了Queues.N.QueueImageIdImageId时,默认使用Queues.N.QueueImageId
    • 如果设置了Queues.N.QueueImageIdImageId,以设置的参数为准。
    • 如果Queues.N.QueueImageIdImageId都为空,则默认使用集群上次扩容的镜像,若之前没有进行过扩容,则默认使用创建集群时的镜像。
    centos_7_03_64_20G_alibase_201708****
    Queuesobject []

    队列信息。

    QueueImageIdstring

    扩容队列的镜像 ID。N 的取值范围:1~8

    说明
  • 如果同时设置了Queues.N.QueueImageIdImageId时,默认使用Queues.N.QueueImageId
    • 如果设置了Queues.N.QueueImageIdImageId,以设置的参数为准。
    • 如果Queues.N.QueueImageIdImageId都为空,则默认使用集群上次扩容的镜像,若之前没有进行过扩容,则默认使用创建集群时的镜像。
    centos_7_03_64_20G_alibase_201708****
    SystemDiskCategorystring

    队列中扩容的计算节点系统盘类型。取值范围:

    • cloud_efficiency:高效云盘
    • cloud_ssd:SSD 云盘
    • cloud_essd:ESSD 云盘
    • cloud:普通云盘,已售罄

    N 的取值范围:1~8

    默认值:cloud_efficiency

    cloud_efficiency
    InstanceTypestring

    队列中自动扩容的节点规格。N 的取值范围:1~8

    ecs.n1.medium
    HostNameSuffixstring

    队列中扩容的主机名后缀。方便您管理具有指定后缀的节点。

    N 的取值范围:1~8

    000
    SpotStrategystring

    队列中自动扩容的计算节点的抢占策略。N 的取值范围:1~8

    抢占策略取值范围为:

    • NoSpot:正常按量付费节点。
    • SpotWithPriceLimit:设置上限价格的抢占式节点。
    • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的抢占式节点。

    默认值:NoSpot

    NoSpot
    HostNamePrefixstring

    队列中扩容的主机名前缀。方便您管理具有指定前缀的节点。

    N 的取值范围:1~8

    compute
    MinNodesInQueueinteger

    队列允许收缩的最小节点数。取值范围:0~50

    N 的取值范围:1~8

    默认值:0

    0
    SystemDiskSizeinteger

    队列中扩容的节点系统盘大小。单位:GB

    取值范围:40~500

    N 的取值范围:1~8

    默认值:40

    40
    MaxNodesInQueueinteger

    队列允许扩容的最大节点数。取值范围:0~500

    N 的取值范围:1~8

    默认值:100

    30
    EnableAutoShrinkboolean

    队列是否允许自动缩容。取值范围:

    • true:允许自动缩容
    • false:不允许自动缩容

    N 的取值范围:1~8

    默认值:false

    false
    QueueNamestring

    队列名称。支持同时设置 N 个队列的名称,N 的取值范围:1~8

    cluster1
    EnableAutoGrowboolean

    队列是否允许自动扩容。取值范围:

    • true:允许自动扩容
    • false:不允许自动扩容

    N 的取值范围:1~8

    默认值:false

    false
    SystemDiskLevelstring

    队列中扩容的计算节点系统盘性能等级。取值范围:

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

    N 的取值范围:1~8

    默认值:PL1

    PL1
    SpotPriceLimitfloat

    队列中自动扩容的计算节点的每小时最高价格,支持最多 3 位小数。参数Queues.N.SpotStrategy取值为SpotWithPriceLimit时生效。

    N 的取值范围:1~8

    0.662
    InstanceTypesobject []

    队列中节点信息。

    VSwitchIdstring

    队列中自动扩容的节点绑定的交换机 ID。

    支持同时设置 N 个队列的名称,N 的取值范围:1~8

    队列自动扩容时支持同时为队列中 N 个节点设置交换机 ID,N 的取值范围:0~500

    vsw-bp1lfcjbfb099rrjn****
    ZoneIdstring

    队列中自动扩容的节点所在可用区 ID。

    支持同时设置 N 个队列的名称,N 的取值范围:1~8

    队列自动扩容时支持同时为队列中 N 个节点设置可用区 ID,N 的取值范围:0~500

    cn-hangzhou-b
    SpotPriceLimitfloat

    队列中自动扩容的节点每小时最高价格,支持最多 3 位小数。参数Queues.N.InstanceTypes.N.SpotStrategy取值为SpotWithPriceLimit时生效。

    支持同时设置 N 个队列的名称,N 的取值范围:1~8

    队列自动扩容时支持同时为队列中 N 个节点设置每小时最高价格,N 的取值范围:0~500

    0.660
    InstanceTypestring

    队列中自动扩容的节点规格。

    支持同时设置 N 个队列的名称,N 的取值范围:1~8

    队列自动扩容时支持同时为队列中 N 个节点设置规格参数,N 的取值范围:0~500

    ecs.n1.tiny
    SpotStrategystring

    队列中自动扩容的计算节点竞价策略。取值范围:

    • NoSpot:正常按量付费节点。
    • SpotWithPriceLimit:设置上限价格的抢占式节点。
    • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的抢占式节点。

    默认值:NoSpot

    支持同时设置 N 个队列的名称,N 的取值范围:1~8

    队列自动扩容时支持同时为队列中 N 个节点设置计算节点竞价策略,N 的取值范围:0~500

    SpotWithPriceLimit
    SpotDurationinteger

    抢占式实例的保护期,单位为小时。取值为 0~1,设置为 0 则表示无保护期,默认为 1。

    0
    SpotInterruptionBehaviorstring

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

    Terminate
    DataDisksobject []

    随节点创建的数据盘信息列表。

    DataDiskSizeinteger

    第 N 个随节点创建的数据盘容量大小。单位:GB

    取值范围:40~500

    默认值:40

    N 的取值范围:0~16

    40
    DataDiskCategorystring

    第 N 个随节点创建的数据盘类型。取值范围:

    • cloud_efficiency:高效云盘

    • cloud_ssd:SSD 云盘

    • cloud_essd:ESSD 云盘

    • cloud:普通云盘

    默认值:cloud_efficiency

    N 的取值范围:0~16

    cloud_efficiency
    DataDiskDeleteWithInstanceboolean

    第 N 个随节点创建的数据盘是否随实例释放。取值范围:

    • true:是

    • false:否

    默认值:true

    N 的取值范围:0~16

    true
    DataDiskPerformanceLevelstring

    第 N 个随节点创建的数据盘类型为 ESSD 云盘时,区分性能等级。仅当 Queues.N.DataDisks.N.DataDiskCategory=cloud_essd 时该参数有效。取值范围:

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

    默认值:PL1

    N 的取值范围:0~16

    PL1
    DataDiskEncryptedboolean

    第 N 个随节点创建的数据盘是否加密。取值范围:

    • true:是

    • false:否

    默认值:false

    N 的取值范围:0~16

    false
    DataDiskKMSKeyIdstring

    第 N 个随节点创建的数据盘使用的 KMS 密钥 ID。

    N 的取值范围:0~16

    0e478b7a-4262-4802-b8cb-00d3fb40826X
    MaxNodesPerCyclelong

    自动伸缩每轮扩容的最大计算节点数。取值范围:0~99。

    默认值:0。

    20
    MinNodesPerCyclelong

    自动伸缩每轮扩容的最小计算节点数。取值范围:1~99。

    默认值:1。

    如果某一轮次需扩容节点数量小于所设置的最小计算节点数,自动伸缩为保证资源的正常交付,会将该轮次的最小计算节点数自动调整为当前轮次需要扩容节点数量。

    说明 该调整仅对当前轮次的最小计算节点数生效。
    5
    AutoMinNodesPerCycleboolean

    自动设置单轮扩容的最小节点数量。 如果设置为 true,则每次扩容的最小节点数等于作业所需的节点数量,上限是 99 台。

    false
    SortedByInventoryboolean

    实例是否支持乱序排列,取值范围:

    • true:是

    • false:否

    说明 如果设置为 true,自动伸缩会按照实例库存数量从多到少的顺序选择实例规格,尽力交付实例资源。
    false
    ComputeEnableHtboolean

    计算节点对应的 ECS 实例是否开启超线程。

    说明 该配置仅对部分支持开关超线程的实例规格生效。对于不支持的实例,默认开启超线程。具体请参见自定义 CPU 选项
    true
    DnsConfigstring

    DNS 配置信息。

    "{\"DnsType\":\"PrivateZone\",\"DnsName\":\"xxxxx\"}"

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID。

    04F0F334-13358736C-A1D7-6C044FE7****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "04F0F334-13358736C-A1D7-6C044FE7****"
    }

    错误码

    HTTP status code错误码错误信息描述
    400InvalidParamsThe specified parameter %s is invalid.无效的参数:%s
    403InvalidOptThe specified operation is invalid. Please try again later. If the problem still exists, submit a ticket.-
    403TooManyComputesThe number of computing nodes exceeds the quota.计算节点数超过用户配额
    404ClusterNotFoundThe specified cluster does not exist.指定的集群不存在,请您检查该参数是否正确。
    404ImageNotFoundThe specified image does not exist.指定的镜像不存在,请您检查该参数是否正确。
    406DbErrorA database service error occurred.数据库请求失败
    407NotAuthorizedYou are not authorized by RAM for this request.此请求未获得RAM授权
    500UnknownErrorAn unknown error occurred.未知错误
    503ServiceUnavailableThe request has failed due to a temporary failure of the server请求失败,服务暂时不可用

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

    变更历史

    变更时间变更内容概要操作
    2023-08-11OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
      删除错误码:406
      删除错误码:407
      删除错误码:500
      删除错误码:503
    2023-07-13OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
      删除错误码:406
      删除错误码:407
      删除错误码:500
      删除错误码:503
    入参OpenAPI 入参发生变更
      新增入参:DnsConfig
    2023-05-23OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
      删除错误码:406
      删除错误码:407
      删除错误码:500
      删除错误码:503
    2023-03-28OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
      删除错误码:406
      删除错误码:407
      删除错误码:500
      删除错误码:503
    2023-03-28OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
      删除错误码:406
      删除错误码:407
      删除错误码:500
      删除错误码:503
    2023-03-15OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
      删除错误码:406
      删除错误码:407
      删除错误码:500
      删除错误码:503
    入参OpenAPI 入参发生变更
      新增入参:ComputeEnableHt
    2021-12-23OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
      删除错误码:406
      删除错误码:407
      删除错误码:500
      删除错误码:503