调用ListNodesByQueue查询集群指定队列中的节点信息。

调试

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

请求参数

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

系统规定参数。取值:ListVolumes

ClusterId String ehpc-hz-FYUr32****

集群ID。

QueueName String workq

队列名称。

PageNumber Integer 1

显示的页码,起始值为1。

PageSize Integer 10

每页显示的行数。取值范围:1~50

默认值:10

返回数据

名称 类型 示例值 描述
Nodes Array of NodeInfo

节点列表信息。

NodeInfo
AddTime String 2019-09-18T13:24:29.000Z

节点加入集群的时间。

CreateMode String manual

节点创建方式。可能值:

  • manual:手动扩容
  • autoscale:自动扩容
CreatedByEhpc Boolean true

是否由E-HPC创建的节点。

Expired Boolean false

包年包月节点是否到期。如果是按量付费节点,则为false。

ExpiredTime String 2020-09-18T13:24:29.000Z

包年包月节点到期时间。如果是按量付费节点,则此项为空。

HostName String compute0

节点名称。

HtEnabled Boolean true

是否启用HT。

Id String i-bp13p7vlcb1uihfv****

节点实例ID。

ImageId String centos_7_02_64_20G_alibase_20170818****

镜像ID。

ImageOwnerAlias String system

镜像类型,可能值:

  • system:公共镜像
  • self:自定义镜像
  • others:共享镜像
  • marketplace:镜像市场镜像
IpAddress String 172.168.**.**

节点私网IP地址。

Location String PublicCloud

节点所在位置。可能值:

  • OnPremise:混合云集群。
  • PublicCloud:公有云集群。
LockReason String financial

节点被锁定类型,可能值:

  • financial:因欠费被锁定。
  • security:因安全原因被锁定。
  • recycling:抢占式实例的待释放锁定状态。
  • dedicatedhostfinancial:因为专有宿主机欠费导致ECS实例被锁定。

默认返回为空字符串。

PublicIpAddress String 10.34.**.**

节点的公网IP地址。

RegionId String cn-hangzhou

地域ID。

SpotStrategy String NoSpot

实例的抢占策略。可能值:

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

节点状态。可能值:

  • uninit:未初始化
  • init:初始化中
  • ready:空闲
  • running:运行中
  • exception:异常
  • untracking:未加入集群
TotalResources Struct

资源总量。

Cpu Integer 1

CPU资源总量。单位:核

Gpu Integer 0

GPU资源总量。单位:卡

Memory Integer 1024

内存资源总量。单位:GB

UsedResources Struct

计算节点资源使用量,其他类型节点返回值为空。

Cpu Integer 1

CPU资源总量。单位:核

Gpu Integer 0

GPU资源总量。单位:卡

Memory Integer 1

内存资源总量。单位:GB

VSwitchId String vsw-bp1e47optm9g58zcu****

交换机ID。

Version String 1.0.64

集群所使用的客户端版本号。

VpcId String vpc-bp1gnu8br4ay7beb2w****

专有网络ID。

ZoneId String cn-hangzhou-b

可用区ID。

PageNumber Integer 1

当前页码。

PageSize Integer 1

本页条数。

RequestId String B405FF19-2D5F-4489-A84C-BC15CC1B24BD

请求ID。

TotalCount Integer 1

列表条目总数。

示例

请求示例

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

正常返回示例

XML 格式

<ListNodesByQueueResponse> 
      <TotalCount>1</TotalCount>
      <PageSize>1</PageSize>
      <RequestId>B405FF19-2D5F-4489-A84C-BC15CC1B24BD</RequestId>
      <PageNumber>1</PageNumber>
      <Nodes>
            <NodeInfo>
                  <ImageOwnerAlias>system</ImageOwnerAlias>
                  <Status>untracking</Status>
                  <ZoneId>cn-hangzhou-b</ZoneId>
                  <VSwitchId>vsw-bp1e47optm9g58zcu****</VSwitchId>
                  <Expired>false</Expired>
                  <AddTime>2019-09-18T13:24:29.000Z</AddTime>
                  <PublicIpAddress>10.34.**.**</PublicIpAddress>
                  <CreatedByEhpc>true</CreatedByEhpc>
                  <VpcId>vpc-bp1gnu8br4ay7beb2w****</VpcId>
                  <CreateMode>manual</CreateMode>
                  <Version>1.0.64</Version>
                  <ExpiredTime>2020-09-18T13:24:29.000Z</ExpiredTime>
                  <ImageId>centos_7_02_64_20G_alibase_20170818****</ImageId>
                  <IpAddress>172.168.**.**</IpAddress>
                  <HtEnabled>true</HtEnabled>
                  <RegionId>cn-hangzhou</RegionId>
                  <Id>i-bp13p7vlcb1uihfv****</Id>
                  <LockReason>financial</LockReason>
                  <SpotStrategy>NoSpot</SpotStrategy>
                  <HostName>compute0</HostName>
                  <Location>PublicCloud</Location>
            </NodeInfo>
            <NodeInfo>
                  <UsedResources>
                        <Memory>1</Memory>
                        <Cpu>1</Cpu>
                        <Gpu>0</Gpu>
                  </UsedResources>
                  <TotalResources>
                        <Memory>1024</Memory>
                        <Cpu>1</Cpu>
                        <Gpu>0</Gpu>
                  </TotalResources>
            </NodeInfo>
      </Nodes>
</ListNodesByQueueResponse>

JSON 格式

{
    "TotalCount":"1",
    "PageSize":"1",
    "RequestId":"B405FF19-2D5F-4489-A84C-BC15CC1B24BD",
    "PageNumber":"1",
    "Nodes":{
        "NodeInfo":[
            {
                "ImageOwnerAlias":"system",
                "Status":"untracking",
                "ZoneId":"cn-hangzhou-b",
                "VSwitchId":"vsw-bp1e47optm9g58zcu****",
                "Expired":"false",
                "AddTime":"2019-09-18T13:24:29.000Z",
                "PublicIpAddress":"10.34.**.**",
                "CreatedByEhpc":"true",
                "VpcId":"vpc-bp1gnu8br4ay7beb2w****",
                "CreateMode":"manual",
                "Version":"1.0.64",
                "ExpiredTime":"2020-09-18T13:24:29.000Z",
                "ImageId":"centos_7_02_64_20G_alibase_20170818****",
                "IpAddress":"172.168.**.**",
                "HtEnabled":"true",
                "RegionId":"cn-hangzhou",
                "Id":"i-bp13p7vlcb1uihfv****",
                "LockReason":"financial",
                "SpotStrategy":"NoSpot",
                "HostName":"compute0",
                "Location":"PublicCloud"
                },
                {
                    "UsedResources":{
                        "Memory":"1",
                        "Cpu":"1",
                        "Gpu":"0"
                        },
                    "TotalResources":{
                            "Memory":"1024",
                            "Cpu":"1",
                            "Gpu":"0"
                        }
                }
            ]
        }
}

错误码

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

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