ListNodes - 查询计算节点列表

更新时间:
复制 MD 格式

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

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ehpc:ListNodes

list

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

ClusterId

string

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

ehpc-hz-FYUr32****

Hostnames

array

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

string

计算节点主机名。

compute000

PrivateIpAddress

array

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

string

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

172.16.**.**

PageNumber

integer

当前页码。

1

PageSize

integer

本页条数。

1

Sequence

string

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

  • Forward:正序排序。

  • Backward:逆序排序。

默认值:Forward

Forward

SortBy

string

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

  • addedtime:按加入时间排序。

  • hostname:按节点主机名称排序。

默认值:addedtime

AddedTime

QueueNames

array

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

string

队列名称。

comp

Status

array

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

string

计算节点状态,可选值:

  • uninit:安装中。

  • initing:初始化中。

  • running:运行中。

  • releasing:释放中。

  • stopped:已停止。

  • exception:异常。

  • untracking:未加入集群。

running

返回参数

名称

类型

描述

示例值

object

返回结果。

PageSize

integer

本页条数。

1

RequestId

string

请求 ID。

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

PageNumber

integer

当前页码。

1

TotalCount

integer

列表条目总数。

1

Nodes

array<object>

计算节点列表信息。

array<object>

节点列表信息。

VpcId

string

专有网络 ID。

vpc-bp1gnu8br4ay7beb2w****

Status

string

计算节点状态,可选值:

  • uninit:安装中。

  • initing:初始化中。

  • running:运行中。

  • releasing:释放中。

  • stopped:已停止。

  • exception:异常。

  • untracking:未加入集群。

running

HtEnabled

boolean

是否开启超线程。

true

Hostname

string

计算节点主机名称。

edas.cn-shanghai.aliyuncs.com

InstanceType

string

计算节点实例规格。

ecs.c5.large

PublicIpAddress

string

计算节点的公网 IP 地址。

172.16.**.**

SpotStrategy

string

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

  • NoSpot:正常按量付费实例。

  • SpotWithPriceLimit:设置上限价格的抢占式实例。

  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。

NoSpot

VSwitchId

string

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

vsw-bp1e47optm9g58zcu****

IpAddress

string

计算节点的 VPC 网络 IP。

172.16.**.**

ExpiredTime

string

计算节点的到期时间,采用 ISO 8601 格式的 UTC 时间,例如 YYYY-MM-DDTHH:mm:ss.SSSZ。

2020-06-09T06:22:02.000Z

ZoneId

string

计算节点的可用区 ID。

cn-hangzhou-b

AddTime

string

计算节点的创建时间,采用 ISO 8601 格式的 UTC 时间,例如 YYYY-MM-DDTHH:mm:ss.SSSZ。

2020-06-09T06:22:02.000Z

ImageId

string

计算节点的镜像 ID。

centos_7_06_64_20G_alibase_20190711.vhd

Id

string

计算节点的实例 ID。

i-bp15707mys2rsy0j****

TotalResources

object

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

Gpu

integer

GPU 卡数量。

0

Cpu

integer

vCPU 数量。

1

Memory

integer

内存量,单位 GiB。

1024

StateInSched

string

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

active

QueueName

string

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

autoque3

KeepAlive

boolean

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

  • true:开启。

  • false:关闭。

true

DeploymentSetId

string

部署集 ID。

ds-8vbe4av4gededlqg****

Reason

string

示例

正常返回示例

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,
      "DeploymentSetId": "ds-8vbe4av4gededlqg****",
      "Reason": ""
    }
  ]
}

错误码

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

变更历史

更多信息,参考变更详情