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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SetAutoScaleConfig

系统规定参数。取值：SetAutoScaleConfig
ClusterId String 是 ehpc-hz-FYUr32****

集群ID。
MaxNodesInCluster Integer 是 100

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

默认值：100
EnableAutoGrow Boolean 否 true

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

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

默认值： false
EnableAutoShrink Boolean 否 false

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

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

默认值： false
GrowIntervalInMinutes Integer 否 2

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

取值范围：2~10

默认值：2
ShrinkIntervalInMinutes Integer 否 2

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

取值范围：2~10

默认值：2
ShrinkIdleTimes Integer 否 3

节点连续空闲次数。节点收缩检查时，一个节点连续处于空闲状态的次数。

取值范围：2~5

默认值：3

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

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

取值范围：10~60

默认值：20

说明 如果扩容时间大于扩容超时时间，节点依然未达到运行状态，系统将此节点重置，用于新的扩容。
ExtraNodesGrowRatio Integer 否 0

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

默认值：0

说明 如果作业负载需要新增100个计算节点，ExtraNodesGrowRatio值为2，那么最终新增数量为102。
GrowRatio Integer 否 50

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

默认值：100

说明 如果作业负载需要新增10个计算节点，GrowRatio配置为50，那么最终新增5个计算节点。
ExcludeNodes String 否 i-bp19lgqwxb4206t5****,i-bp1g4hvzs9pywrhb****

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

说明 如果您希望一直保留某个节点，可以设置为例外节点，空闲时不被释放。
SpotStrategy String 否 SpotWithPriceLimit

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

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

默认值：NoSpot
SpotPriceLimit Float 否 0.66

设置实例的每小时最高价格，支持最多3位小数。参数SpotStrategy取值为SpotWithPriceLimit时生效。
Queues.N.QueueName String 否 cluster1

第N个队列名称。N的取值范围：1~8
Queues.N.InstanceTypes.N.InstanceType String 否 ecs.n1.tiny

第N个队列中第N个自动扩容的实例规格。
Queues.N.InstanceTypes.N.SpotStrategy String 否 SpotWithPriceLimit

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

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

默认值：NoSpot
Queues.N.InstanceTypes.N.SpotPriceLimit Float 否 0.66

设置第N队列中第N个自动扩容的实例每小时最高价格，支持最多3位小数。参数Queues.N.InstanceTypes.N.SpotStrategy取值为SpotWithPriceLimit时生效。
Queues.N.InstanceTypes.N.ZoneId String 否 cn-hangzhou-b

第N个队列中第N个自动扩容的实例规格所在可用区ID。
Queues.N.InstanceTypes.N.VSwitchId String 否 vsw-bp1lfcjbfb099rrjn****

第N个队列中第N个自动扩容的实例规格绑定的交换机ID。
Queues.N.InstanceTypes.N.HostNamePrefix String 否 Test

第N个队列中的第N个自动扩容的主机前缀名。
Queues.N.InstanceType String 否 ecs.n1.medium

第N个队列自动扩容的实例规格。
Queues.N.SpotStrategy String 否 SpotWithPriceLimit

第N个队列自动扩容的计算节点实例的抢占策略。N的取值范围：1~8

抢占策略取值范围为：

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

默认值：NoSpot
Queues.N.SpotPriceLimit Float 否 0.66

第N个队列自动扩容的计算节点实例的每小时最高价格，支持最多3位小数。参数Queues.N.SpotStrategy取值为SpotWithPriceLimit时生效。
Queues.N.EnableAutoGrow Boolean 否 false

第N个队列是否允许自动扩容。取值范围：

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

默认值：false
Queues.N.EnableAutoShrink Boolean 否 false

第N个队列是否允许自动缩容。取值范围：

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

默认值：false
Queues.N.MaxNodesInQueue Integer 否 30

第N个队列可允许扩容的最大节点数。取值范围：1~500

默认值：100
Queues.N.MinNodesInQueue Integer 否 0

第N个队列可允许收缩的最小节点数。取值范围：1~500

默认值：0
Queues.N.QueueImageId String 否 centos_7_03_64_20G_alibase_201708****

第N个扩容队列的镜像ID。
ImageId String 否 centos_7_03_64_20G_alibase_201708****

镜像ID。

说明 当Queues.N.QueueImageId未设置时，扩容默认使用该镜像，若该字段也为空，则默认使用集群上次扩容的镜像。

返回数据

名称 类型 示例值 描述
RequestId String 04F0F334-13358736C-A1D7-6C044FE73368

请求ID。

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=SetAutoScaleConfig
&ClusterId=ehpc-hz-FYUr32****
&MaxNodesInCluster=100
&<公共请求参数>

正常返回示例

XML格式 

<SetAutoScaleConfigResponse>
      <RequestId>04F0F334-13358736C-A1D7-6C044FE73368</RequestId>
</SetAutoScaleConfigResponse>

JSON格式 

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

错误码

HttpCode 错误码 错误信息 描述
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用

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