ListNodes - 查询计算节点列表

查询E-HPC集群的节点列表。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ehpc:ListNodeslist
  • 全部资源
    *

请求参数

名称类型必填描述示例值
ClusterIdstring

集群 ID。您可以通过调用 listclusters 获取集群 ID。

ehpc-hz-FYUr32****
Hostnamesarray

待查询计算节点的主机名列表。

string

计算节点主机名。

compute000
PrivateIpAddressarray

待查询计算节点的 IP 地址列表。

string

计算节点的 VPC 网络的 IP 地址。

172.16.**.**
PageNumberinteger

当前页码。

1
PageSizeinteger

本页条数。

1
Sequencestring

节点列表排序方式。取值范围:

  • Forward:正序排序。
  • Backward:逆序排序。

默认值:Forward

Forward
SortBystring

节点列表排序方式。取值范围:

  • addedtime:按加入时间排序。
  • hostname:按节点主机名称排序。

默认值:addedtime

AddedTime
QueueNamesarray

待查询计算节点所属的队列列表。

string

队列名称。

comp
Statusarray

待查询计算节点的状态列表。

string

计算节点状态,可选值:

  • uninit:安装中。
  • initing:初始化中。
  • running:运行中。
  • releasing:释放中。
  • stopped:已停止。
  • exception:异常。
  • untracking:未加入集群。
running

返回参数

名称类型描述示例值
object

返回结果。

PageSizeinteger

本页条数。

1
RequestIdstring

请求 ID。

89A1AC0F-4A6C-4F3D-98F9-BEF9A823****
PageNumberinteger

当前页码。

1
TotalCountinteger

列表条目总数。

1
Nodesarray<object>

计算节点列表信息。

NodeInfoobject

节点列表信息。

VpcIdstring

专有网络 ID。

vpc-bp1gnu8br4ay7beb2w****
Statusstring

计算节点状态,可选值:

  • uninit:安装中。
  • initing:初始化中。
  • running:运行中。
  • releasing:释放中。
  • stopped:已停止。
  • exception:异常。
  • untracking:未加入集群。
running
HtEnabledboolean

是否开启超线程。

true
Hostnamestring

计算节点主机名称。

edas.cn-shanghai.aliyuncs.com
InstanceTypestring

计算节点实例规格。

ecs.c5.large
PublicIpAddressstring

计算节点的公网 IP 地址。

172.16.**.**
SpotStrategystring

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

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

计算节点所属的虚拟交换机 ID。

vsw-bp1e47optm9g58zcu****
IpAddressstring

计算节点的 VPC 网络 IP。

172.16.**.**
ExpiredTimestring

计算节点的到期时间。

2020-06-09T06:22:02.000Z
ZoneIdstring

计算节点的可用区 ID。

cn-hangzhou-b
AddTimestring

计算节点的创建时间。

2020-06-09T06:22:02.000Z
ImageIdstring

计算节点的镜像 ID。

centos_7_06_64_20G_alibase_20190711.vhd
Idstring

计算节点的实例 ID。

i-bp15707mys2rsy0j****
TotalResourcesobject

计算节点的硬件配置信息。

Gpuinteger

GPU 卡数量。

0
Cpuinteger

vCPU 数量。

1
Memoryinteger

内存量,单位 GiB。

1024
StateInSchedstring

计算节点在调度器中的状态。

active
QueueNamestring

计算节点所属的队列名称。

autoque3
KeepAliveboolean

计算节点是否开启删除保护。可能值:

  • true:开启。
  • false:关闭。
true

示例

正常返回示例

JSON格式

{
  "PageSize": 1,
  "RequestId": "89A1AC0F-4A6C-4F3D-98F9-BEF9A823****",
  "PageNumber": 1,
  "TotalCount": 1,
  "Nodes": [
    {
      "VpcId": "vpc-bp1gnu8br4ay7beb2w****",
      "Status": "running",
      "HtEnabled": true,
      "Hostname": "edas.cn-shanghai.aliyuncs.com",
      "InstanceType": "ecs.c5.large",
      "PublicIpAddress": "172.16.**.**",
      "SpotStrategy": "NoSpot",
      "VSwitchId": "vsw-bp1e47optm9g58zcu****",
      "IpAddress": "172.16.**.**",
      "ExpiredTime": "2020-06-09T06:22:02.000Z",
      "ZoneId": "cn-hangzhou-b",
      "AddTime": "2020-06-09T06:22:02.000Z",
      "ImageId": "centos_7_06_64_20G_alibase_20190711.vhd",
      "Id": "i-bp15707mys2rsy0j****",
      "TotalResources": {
        "Gpu": 0,
        "Cpu": 1,
        "Memory": 1024
      },
      "StateInSched": "active",
      "QueueName": "autoque3",
      "KeepAlive": true
    }
  ]
}

错误码

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