调用SetAutoScaleConfig设置自动伸缩配置信息。

调试

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

请求参数

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

操作接口名,系统规定参数,取值:SetAutoScaleConfig

ClusterId String ehpc-123456

集群ID。

MaxNodesInCluster Integer 100

集群最大计算节点数,集群最多可以扩展的节点数量,默认值100,最小值1。

EnableAutoGrow Boolean true

是否允许自动扩容,取值:true | false

EnableAutoShrink Boolean false

是否允许自动缩容,取值:true | false

GrowIntervalInMinutes Integer 2

扩容时间间隔,每轮资源扩展的时间间隔。默认值2分钟,最小值2分钟,最大值10分钟。

ShrinkIntervalInMinutes Integer 2

缩容时间间隔,每轮资源收缩的时间间隔,默认2分钟,最小值2分钟,最大值10分钟。

ShrinkIdleTimes Integer 3

节点连续空闲次数,资源收缩检查时,一个节点连续处于空闲的次数。默认值3,最小值2。最大值5。如果一个计算节点连续空闲超过3次,就会被释放。所以默认配置下,一个资源的连续空闲时间超过6分钟,就会被释放。

GrowTimeoutInMinutes Integer 20

扩容超时时间,等待启动节点的超时时间。默认值20分钟,最小值10分钟,最大值60分钟。如果超时时间后,节点依然未达到运行状态,将会把这个节点重置,用于新的扩容。

ExtraNodesGrowRatio Integer 0

额外节点百分比,默认值0,最小值0, 最大值100。例如,根据作业负载需要新增100个计算节点,ExtraNodesGrowRatio值为2,那么最终扩展的节点数量是102。

GrowRatio Integer 10

扩容比例,扩展比例(百分比)默认值100,最小值1,最大值100。比如当前根据作业负载需要新增10个计算节点,如果GrowRatio配置为50,就新增5个计算节点。

ExcludeNodes String i-12345678,i-87654321

例外节点列表,不使用自动伸缩的节点列表,以半角逗号分割。用户如果希望一直保留一个最小规模的集群,可以使用此配置项。

SpotStrategy String SpotWithPriceLimit

计算节点竞价策略,取值NoSpot, SpotWithPriceLimitSpotAsPriceGo

SpotPriceLimit Float 0.66

设置实例的每小时最高价格,取值是数字,浮点数,取值范围是当前的价格区间 (Deprecated,推荐设置Queues参数)

Queues.N.QueueName String cluster1

第n个集群队列名,n的取值为:1~8。

Queues.N.InstanceTypes.N.InstanceType String ecs.n1.tiny

第n个集群队列中第n个自动扩容的实例规格,n的取值为:1~8。。

Queues.N.InstanceTypes.N.SpotStrategy String SpotWithPriceLimit

第n个集群队列中的第n个计算节点竞价策略,n的取值为:1~8,竞价策略的取值NoSpot, SpotWithPriceLimitSpotAsPriceGo。

Queues.N.InstanceTypes.N.SpotPriceLimit Float 0.66

第n个集群队列的第n个实例,设置该实例的每小时最高价格,取值是数字,浮点数,取值范围是当前的价格区间,n的取值为:1~8。。

Queues.N.InstanceTypes.N.ZoneId String cn-hangzhou-b

第n个集群队列中第n个自动扩容的实例规格所在可用区ID,n的取值为:1~8。。

Queues.N.InstanceTypes.N.VSwitchId String vs-123455678

第 n 个集群队列中第n个自动扩容的实例规格绑定的交换机ID,n的取值为:1~8。。

Queues.N.InstanceTypes.N.HostNamePrefix String Test

第 n 个集群队列中的第n个自动扩容的主机前缀名,n的取值为:1~8。。

Queues.N.InstanceType String ecs.n1.medium

第 n 个自动扩容的实例规格,n的取值为:1~8。。

Queues.N.SpotStrategy String SpotWithPriceLimit

第 n 个计算节点竞价策略,取值NoSpot, SpotWithPriceLimitSpotAsPriceGo,n的取值为:1~8。。

Queues.N.SpotPriceLimit Float 0.66

第 n 个设置实例的每小时最高价格,取值是数字,浮点数,取值范围是当前的价格区间,n的取值为:1~8。。

Queues.N.EnableAutoGrow Boolean false

第n个设置实例是否允许自动扩容,n的取值为:1~8。。

Queues.N.EnableAutoShrink Boolean false

第n个设置实例是否允许自动缩容,n的取值为:1~8。。

Queues.N.MaxNodesInQueue Integer 30

第n个设置队列可允许扩容的最大节点数,n的取值为:1~8。。

Queues.N.MinNodesInQueue Integer 0

第n个设置队列可允许扩容的最小节点数,n的取值为:1~8。。

Queues.N.QueueImageId String centos_7_03_64_20G_alibase_20170818.vhd

第n个设置队列的镜像类型镜像ID。

ImageId String m-bp1h8aoe73p71iowjk96

镜像ID。注:当队列镜像未设置时,扩容默认使用该镜像,若该字段也为空,则扩容默认使用集群上次扩容的镜像。

返回数据

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

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=SetAutoScaleConfig
&ClusterId=ehpc-123456
&MaxNodesInCluster=100
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>

JSON 格式

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

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams Invalid param: %s 无效的参数: {}

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