调用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

计算节点抢占策略。可能值:

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

集群是否启动自动缩容。可能值:

  • true
  • false
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。

EnableAutoGrow Boolean true

集群是否启动自动扩容。可能值:

  • true
  • false
ClusterType String pbs

集群的调度器类型。可能值:

  • slurm
  • pbs
  • opengridscheduler
  • deadline
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

系统盘类型。可能值:

  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
  • cloud_essd:ESSD云盘
  • cloud:普通云盘
InstanceType String ecs.sn1ne.large

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

HostNameSuffix String 000

队列名后缀。方便您查询具有指定后缀的队列。

SpotStrategy String NoSpot

计算节点的抢占策略。可能值:

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

单个队列最小计算节点数,队列最少可以保留的计算节点数量。可能值:0~50

HostNamePrefix String compute

队列名前缀。方便您查询具有指定前缀的队列。

SystemDiskSize Integer 40

系统盘大小。单位:GB,可能值:40~500

MaxNodesInQueue Integer 100

单个队列最多可以扩容的节点数量。可能值:0~500

EnableAutoShrink Boolean true

队列是否启动自动缩容。可能值:

  • true
  • false
QueueName String workq

队列名称。

EnableAutoGrow Boolean true

队列是否启动自动扩容。可能值:

  • true
  • false
SystemDiskLevel String PL1

系统盘性能等级。可能值:

  • PL0:单盘最高随机读写IOPS 1万
  • PL1:单盘最高随机读写IOPS 5万
  • PL2:单盘最高随机读写IOPS10万
  • PL3:单盘最高随机读写IOPS 100万
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

计算节点竞价策略。可能值:

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

节点上挂载的数据盘信息列表。

DataDisksInfo
DataDiskCategory String cloud_efficiency

第N个该节点挂载的数据盘类型。可能值:

  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
  • cloud_essd:ESSD云盘
  • cloud:普通云盘
DataDiskSize Integer 40

第N个该节点挂载的数据盘容量大小。单位:GB

可能值:40~500

DataDiskDeleteWithInstance Boolean true

第N个该节点挂载的数据盘是否随实例释放。可能值:

  • true:是
  • false:否
DataDiskPerformanceLevel String PL1

第N个该节点的数据盘类型为ESSD云盘时,区分性能等级。仅当DataDisks.N.DataDiskCategory=cloud_essd时返回该参数。可能值:

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

第N个该节点的数据盘是否加密。可能值:

  • true:是
  • false:否
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 请求失败,服务暂时不可用

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