GetAutoScaleConfig - 弹性高性能计算E-HPC

调试

您可以在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	请求失败，服务暂时不可用

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