调用GetAutoScaleConfig获取指定集群的自动伸缩配置信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetAutoScaleConfig |
系统规定参数。取值:GetAutoScaleConfig。 |
ClusterId | String | 是 | ehpc-hz-FYUr32**** |
集群ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
MaxNodesInCluster | Integer | 300 |
集群最多可以扩容的节点数量。可能值:0~500 |
GrowTimeoutInMinutes | Integer | 20 |
扩容超时时间,等待启动节点的超时时间。单位:分钟,可能值:10~60 如果扩容时间大于扩容超时时间,节点依然未达到运行状态,系统将此节点释放。 |
SpotStrategy | String | SpotWithPriceLimit |
计算节点抢占策略。可能值:
|
EnableAutoShrink | Boolean | true |
集群是否启动自动缩容。可能值:
|
RequestId | String | 04F0F334-1335-436C-A1D7-6C044FE73368 |
请求ID。 |
EnableAutoGrow | Boolean | true |
集群是否启动自动扩容。可能值:
|
ClusterType | String | pbs |
集群的调度器类型。可能值:
|
ExcludeNodes | String | i-bp19lgqwxb4206t5****,i-bp1g4hvzs9pywrhb**** |
不参与自动伸缩的节点列表,多个节点之间用半角逗号(,)隔开。 |
ShrinkIntervalInMinutes | Integer | 2 |
缩容时间间隔,每轮计算节点收缩的时间间隔。单位:分钟,可能值:2~10 |
GrowIntervalInMinutes | Integer | 2 |
扩容时间间隔,每轮计算节点扩容的时间间隔。单位:分钟,可能值:2~10 说明 一次扩容任务可能会分几次完成,或者连续触发扩容时的时间间隔。
|
SpotPriceLimit | Float | 0.062 |
计算节点每小时最高价格,最多支持3位小数。参数SpotStrategy取值为SpotWithPriceLimit时生效。 |
ExtraNodesGrowRatio | Integer | 2 |
额外节点百分比。可能值:0~100 如果作业负载需要新增100个计算节点,ExtraNodesGrowRatio值为2,那么最终新增数量为102。 |
ShrinkIdleTimes | Integer | 3 |
节点连续空闲(未运行作业)次数。节点收缩检查时,一个节点连续处于空闲状态的次数。可能值:2~5 如果该参数值为3,表示一个计算节点连续空闲超过3次,就会被释放。 |
ImageId | String | m-bp10txryr4mhrrt1**** |
队列中计算节点镜像ID。 |
GrowRatio | Integer | 100 |
扩容比例。可能值:1~100 如果作业负载需要新增10个计算节点,GrowRatio配置为50,那么会进行多轮扩容,每轮扩容当前所需的50%。 |
ClusterId | String | ehpc-hz-FYUr32**** |
集群ID。 |
Uid | String | 129845258050**** |
阿里云账号ID。 |
Queues | Array of QueueInfo |
集群队列的自动伸缩配置信息。 说明 集群和队列同时开启了扩容或缩容时,则以队列设置为优先。
|
|
QueueInfo | |||
QueueImageId | String | centos_7_06_64_20G_alibase_2019071**** |
队列中计算节点镜像ID。 |
SystemDiskCategory | String | cloud_efficiency |
系统盘类型。可能值:
|
InstanceType | String | ecs.sn1ne.large |
该队列自动扩容的节点规格。 |
HostNameSuffix | String | 000 |
队列名后缀。方便您查询具有指定后缀的队列。 |
SpotStrategy | String | NoSpot |
计算节点的抢占策略。可能值:
|
MinNodesInQueue | Integer | 10 |
单个队列最小计算节点数,队列最少可以保留的计算节点数量。可能值:0~50 |
HostNamePrefix | String | compute |
队列名前缀。方便您查询具有指定前缀的队列。 |
SystemDiskSize | Integer | 40 |
系统盘大小。单位:GB,可能值:40~500 |
MaxNodesInQueue | Integer | 100 |
单个队列最多可以扩容的节点数量。可能值:0~500 |
EnableAutoShrink | Boolean | true |
队列是否启动自动缩容。可能值:
|
QueueName | String | workq |
队列名称。 |
EnableAutoGrow | Boolean | true |
队列是否启动自动扩容。可能值:
|
SystemDiskLevel | String | PL1 |
系统盘性能等级。可能值:
|
ResourceGroupId | String | rg-acfmxp7uc24**** |
计算节点所属的资源组ID。 |
SpotPriceLimit | Float | 0.062 |
计算节点每小时最高价格,支持最大3位小数。参数SpotStrategy取值为SpotWithPriceLimit时生效。 |
InstanceTypes | Array of InstanceTypeInfo |
计算节点规格信息。 |
|
InstanceTypeInfo | |||
HostNamePrefix | String | compute |
主机名前缀。方便您查询具有指定前缀的节点。 |
VSwitchId | String | vsw-bp1lfcjbfb099rrjn**** |
计算节点所属的交换机ID。 |
ZoneId | String | cn-hangzhou-b |
计算节点所属的可用区ID。 |
SpotPriceLimit | Float | 0.062 |
计算节点每小时最高价格,支持最多3位小数。参数SpotStrategy取值为SpotWithPriceLimit时生效。 |
InstanceType | String | ecs.sn1ne.large |
节点规格。 |
SpotStrategy | String | NoSpot |
计算节点竞价策略。可能值:
|
DataDisks | Array of DataDisksInfo |
节点上挂载的数据盘信息列表。 |
|
DataDisksInfo | |||
DataDiskCategory | String | cloud_efficiency |
第N个该节点挂载的数据盘类型。可能值:
|
DataDiskSize | Integer | 40 |
第N个该节点挂载的数据盘容量大小。单位:GB 可能值:40~500 |
DataDiskDeleteWithInstance | Boolean | true |
第N个该节点挂载的数据盘是否随实例释放。可能值:
|
DataDiskPerformanceLevel | String | PL1 |
第N个该节点的数据盘类型为ESSD云盘时,区分性能等级。仅当DataDisks.N.DataDiskCategory=cloud_essd时返回该参数。可能值:
|
DataDiskEncrypted | Boolean | false |
第N个该节点的数据盘是否加密。可能值:
|
DataDiskKMSKeyId | String | 0e478b7a-4262-4802-b8cb-00d3fb40826X |
第N个该节点的数据盘使用的KMS密钥ID。 |
MaxNodesPerCycle | Long | 20 |
自动伸缩每轮扩容的最大计算节点数。取值范围:0~99。 默认值:0。 |
MinNodesPerCycle | Long | 5 |
自动伸缩每轮扩容的最小计算节点数。取值范围:1~99。 默认值:1。 如果某一轮次需扩容节点数量小于所设置的最小计算节点数,自动伸缩为保证资源的正常交付,会将该轮次的最小计算节点数自动调整为当前轮次需要扩容节点数量。 说明 该调整仅对当前轮次的最小计算节点数生效。
|
示例
请求示例
http(s)://ehpc.cn-hangzhou.aliyuncs.com/?Action=GetAutoScaleConfig
&ClusterId=ehpc-hz-FYUr32****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetAutoScaleConfigResponse>
<MaxNodesInCluster>300</MaxNodesInCluster>
<GrowTimeoutInMinutes>20</GrowTimeoutInMinutes>
<SpotStrategy>SpotWithPriceLimit</SpotStrategy>
<EnableAutoShrink>true</EnableAutoShrink>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
<EnableAutoGrow>true</EnableAutoGrow>
<ClusterType>pbs</ClusterType>
<ExcludeNodes>i-bp19lgqwxb4206t5****,i-bp1g4hvzs9pywrhb****</ExcludeNodes>
<ShrinkIntervalInMinutes>2</ShrinkIntervalInMinutes>
<GrowIntervalInMinutes>2</GrowIntervalInMinutes>
<SpotPriceLimit>0.062</SpotPriceLimit>
<ExtraNodesGrowRatio>2</ExtraNodesGrowRatio>
<ShrinkIdleTimes>3</ShrinkIdleTimes>
<ImageId>m-bp10txryr4mhrrt1****</ImageId>
<GrowRatio>100</GrowRatio>
<ClusterId>ehpc-hz-FYUr32****</ClusterId>
<Uid>129845258050****</Uid>
<Queues>
<QueueImageId>centos_7_06_64_20G_alibase_2019071****</QueueImageId>
<SystemDiskCategory>cloud_efficiency</SystemDiskCategory>
<InstanceType>ecs.sn1ne.large</InstanceType>
<HostNameSuffix>000</HostNameSuffix>
<SpotStrategy>NoSpot</SpotStrategy>
<MinNodesInQueue>10</MinNodesInQueue>
<HostNamePrefix>compute</HostNamePrefix>
<SystemDiskSize>40</SystemDiskSize>
<MaxNodesInQueue>100</MaxNodesInQueue>
<EnableAutoShrink>true</EnableAutoShrink>
<QueueName>workq</QueueName>
<EnableAutoGrow>true</EnableAutoGrow>
<SystemDiskLevel>PL1</SystemDiskLevel>
<ResourceGroupId>rg-acfmxp7uc24****</ResourceGroupId>
<SpotPriceLimit>0.062</SpotPriceLimit>
<InstanceTypes>
<HostNamePrefix>compute</HostNamePrefix>
<VSwitchId>vsw-bp1lfcjbfb099rrjn****</VSwitchId>
<ZoneId>cn-hangzhou-b</ZoneId>
<SpotPriceLimit>0.062</SpotPriceLimit>
<InstanceType>ecs.sn1ne.large</InstanceType>
<SpotStrategy>NoSpot</SpotStrategy>
</InstanceTypes>
<DataDisks>
<DataDiskCategory>cloud_efficiency</DataDiskCategory>
<DataDiskSize>40</DataDiskSize>
<DataDiskDeleteWithInstance>true</DataDiskDeleteWithInstance>
<DataDiskPerformanceLevel>PL1</DataDiskPerformanceLevel>
<DataDiskEncrypted>false</DataDiskEncrypted>
<DataDiskKMSKeyId>0e478b7a-4262-4802-b8cb-00d3fb40826X</DataDiskKMSKeyId>
</DataDisks>
</Queues>
</GetAutoScaleConfigResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"MaxNodesInCluster" : 300,
"GrowTimeoutInMinutes" : 20,
"SpotStrategy" : "SpotWithPriceLimit",
"EnableAutoShrink" : true,
"RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368",
"EnableAutoGrow" : true,
"ClusterType" : "pbs",
"ExcludeNodes" : "i-bp19lgqwxb4206t5****,i-bp1g4hvzs9pywrhb****",
"ShrinkIntervalInMinutes" : 2,
"GrowIntervalInMinutes" : 2,
"SpotPriceLimit" : 0.062,
"ExtraNodesGrowRatio" : 2,
"ShrinkIdleTimes" : 3,
"ImageId" : "m-bp10txryr4mhrrt1****",
"GrowRatio" : 100,
"ClusterId" : "ehpc-hz-FYUr32****",
"Uid" : "129845258050****",
"Queues" : [ {
"QueueImageId" : "centos_7_06_64_20G_alibase_2019071****",
"SystemDiskCategory" : "cloud_efficiency",
"InstanceType" : "ecs.sn1ne.large",
"HostNameSuffix" : "000",
"SpotStrategy" : "NoSpot",
"MinNodesInQueue" : 10,
"HostNamePrefix" : "compute",
"SystemDiskSize" : 40,
"MaxNodesInQueue" : 100,
"EnableAutoShrink" : true,
"QueueName" : "workq",
"EnableAutoGrow" : true,
"SystemDiskLevel" : "PL1",
"ResourceGroupId" : "rg-acfmxp7uc24****",
"SpotPriceLimit" : 0.062,
"InstanceTypes" : [ {
"HostNamePrefix" : "compute",
"VSwitchId" : "vsw-bp1lfcjbfb099rrjn****",
"ZoneId" : "cn-hangzhou-b",
"SpotPriceLimit" : 0.062,
"InstanceType" : "ecs.sn1ne.large",
"SpotStrategy" : "NoSpot"
} ],
"DataDisks" : [ {
"DataDiskCategory" : "cloud_efficiency",
"DataDiskSize" : 40,
"DataDiskDeleteWithInstance" : true,
"DataDiskPerformanceLevel" : "PL1",
"DataDiskEncrypted" : false,
"DataDiskKMSKeyId" : "0e478b7a-4262-4802-b8cb-00d3fb40826X"
} ]
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParams | The specified parameter %s is invalid. | 无效的参数:%s |
403 | InvalidOpt | The specified operation is invalid. Please try again later. If the problem still exists, submit a ticket. | 未知的操作,请您稍后再试,若还出现相同的错误请提交工单处理。 |
404 | ClusterNotFound | The specified cluster does not exist. | 指定的集群不存在,请您检查该参数是否正确。 |
406 | DbError | A database service error occurred. | 数据库请求失败 |
500 | UnknownError | An unknown error occurred. | 未知错误,请您稍后再试,若还出现相同的错误请提交工单处理。 |
503 | ServiceUnavailable | The request has failed due to a temporary failure of the server | 请求失败,服务暂时不可用 |
访问错误中心查看更多错误码。