调用ListNodes查询集群中节点列表。

调试

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

请求参数

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

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

ClusterId String ehpc-hz-FYUr32H5yi

集群 ID。

Role String Manager

节点角色,取值:

  • Manager:管控节点
  • Login:跳板机
  • Compute:计算节点
HostName String compute0

节点名称,支持模糊查询,支持 MySQL 的正则表达式。

PageNumber Integer 1

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

PageSize Integer 10

每页显示的条数,取值1~50。

Sequence String Forward

支持正序和逆序查询,取值为Forward和Backward。

  • Forward是按节点的加入时间从早到晚排序。
  • Backward是按节点的加入时间从晚到早排序。
  • 默认是值是Forward。

返回数据

名称 类型 示例值 描述
Nodes Array

节点列表信息。

NodeInfo
AddTime String 2020-06-09T06:22:02.000Z

加入集群时间。

CreateMode String manual

节点创建方式。

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

是否由 E-HPC 创建。

Expired Boolean false

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

ExpiredTime String 2020-06-09T06:22:02.000Z

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

HostName String compute000

节点名称。

HtEnabled Boolean true

是否开启超线程。

Id String i-bp15707mys2rsy0js3j9

节点实例ID。

ImageId String centos_7_06_64_20G_alibase_20190711.vhd

镜像ID。

ImageOwnerAlias String system

镜像类型,system、self、others 或 marketplace。

IpAddress String 172.16.0.249

实例IP地址。

Location String PublicCloud

节点所在位置:

  • OnPremise:本地节点
  • PublicCloud:公共云节点
LockReason String []

节点被锁定类型,默认返回为空字符串。

PublicIpAddress String 172.16.0.55

公网IP地址。

RegionId String cn-hangzhou

地域ID。

Roles List [“Compute”]

节点类别:

  • Scheduler:主调度器
  • SchedulerBackup:备用调度器
  • Account:主域服务器
  • AccountBackup:备用域服务器
  • Login:跳板机
  • Compute:计算节点

调度器和域服务器都属于管控节点(Mananger)。

SpotStrategy String NoSpot

后付费实例的竞价策略。

Status String running

节点状态:

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

资源总量。

Cpu Integer 1

CPU资源总量,单位:核。

Gpu Integer 0

GPU资源总量,单位:卡。

Memory Integer 1024

内存资源总量,单位:GB。

UsedResources Struct

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

Cpu Integer 0

CPU资源总量,单位:核。

Gpu Integer 0

GPU资源总量,单位:卡。

Memory Integer 0

内存资源总量,单位:GB。

VSwitchId String vsw-bp1e47optm9g58zcup0de

交换机ID。

Version String 1.0.78

版本。

VpcId String vpc-bp1gnu8br4ay7beb2wxlxx

专有网络ID。

ZoneId String cn-hangzhou-b

可用区ID。

PageNumber Integer 1

当前页码。

PageSize Integer 1

本页条数。

RequestId String 89A1AC0F-4A6C-4F3D-98F9-BEF9A823A5F7

请求ID。

TotalCount Integer 1

列表条目总数。

示例

请求示例

http(s)://[Endpoint]/?Action=ListNodes
&ClusterId=ehpc-hz-FYUr32H5yi
&<公共请求参数>

正常返回示例

XML 格式

<ListNodes>
      <TotalCount>1</TotalCount>
      <RequestId>89A1AC0F-4A6C-4F3D-98F9-BEF9A823A5F7</RequestId>
      <PageSize>1</PageSize>
      <PageNumber>1</PageNumber>
      <Nodes>
            <NodeInfo>
                  <Status>running</Status>
                  <ImageOwnerAlias>system</ImageOwnerAlias>
                  <ZoneId>cn-hangzhou-h</ZoneId>
                  <VSwitchId>vsw-bp19uonfl1cz47attf5da</VSwitchId>
                  <Expired>false</Expired>
                  <Roles>
                        <Role>Compute</Role>
                  </Roles>
                  <AddTime>2020-06-09T06:22:02.000Z</AddTime>
                  <UsedResources>
                        <Memory>0</Memory>
                        <Cpu>0</Cpu>
                        <Gpu>0</Gpu>
                  </UsedResources>
                  <PublicIpAddress></PublicIpAddress>
                  <CreateMode>manual</CreateMode>
                  <VpcId>vpc-bp1se4wjbp0760yjuje9h</VpcId>
                  <Version>1.0.78</Version>
                  <TotalResources>
                        <Memory>16384</Memory>
                        <Cpu>8</Cpu>
                        <Gpu>0</Gpu>
                  </TotalResources>
                  <ImageId>centos_7_06_64_20G_alibase_20190711.vhd</ImageId>
                  <IpAddress>172.11.76.249</IpAddress>
                  <HtEnabled>true</HtEnabled>
                  <Id>i-bp15707mys2rsy0js3j9</Id>
                  <RegionId>cn-hangzhou</RegionId>
                  <LockReason></LockReason>
                  <HostName>compute000</HostName>
                  <SpotStrategy>NoSpot</SpotStrategy>
                  <Location>PublicCloud</Location>
            </NodeInfo>
      </Nodes>
</ListNodes>

JSON 格式

{

	"TotalCount": 1,
	"RequestId": "89A1AC0F-4A6C-4F3D-98F9-BEF9A823A5F7",
	"PageSize": 1,
	"PageNumber": 1,
	"Nodes": {
		"NodeInfo": [
			{
				"Status": "running",
				"ImageOwnerAlias": "system",
				"ZoneId": "cn-hangzhou-h",
				"VSwitchId": "vsw-bp19uonfl1cz47attf5da",
				"Expired": false,
				"Roles": {
					"Role": [
						"Compute"
					]
				},
				"AddTime": "2020-06-09T06:22:02.000Z",
				"UsedResources": {
					"Memory": 0,
					"Cpu": 0,
					"Gpu": 0
				},
				"PublicIpAddress": "",
				"CreateMode": "manual",
				"VpcId": "vpc-bp1se4wjbp0760yjuje9h",
				"Version": "1.0.78",
				"TotalResources": {
					"Memory": 16384,
					"Cpu": 8,
					"Gpu": 0
				},
				"ImageId": "centos_7_06_64_20G_alibase_20190711.vhd",
				"IpAddress": "172.11.76.249",
				"HtEnabled": true,
				"Id": "i-bp15707mys2rsy0js3j9",
				"RegionId": "cn-hangzhou",
				"LockReason": "",
				"HostName": "compute000",
				"SpotStrategy": "NoSpot",
				"Location": "PublicCloud"
			}
		]
	}
}

错误码

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

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