ListClusterHyperNodes - 查询集群分组列表及分组下的超节点列表

集群下的主机分组列表，分组下的主机列表。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

eflo:ListClusterHyperNodes

get

*Cluster

acs:eflo:{#regionId}:{#accountId}:cluster/{#clusterId}

无

请求参数

名称	类型	必填	描述	示例值
ClusterId	string	是	集群 id	i119982311660892626523
NextToken	string	否	查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值。	563d42ae0b17572449ec8c97f7f66069
MaxResults	integer	否	分页查询时每页行数。最大值为 100。默认值： •当不设置值或设置的值小于 20 时，默认值为 20。 •当设置的值大于 100 时，默认值为 100。	20
NodeGroupId	string	否	节点组 id	ng-ec3c96ff0aa4c60d
Tags	array<object>	否	标签信息
	object	否	标签信息
Key	string	否	标签 key	my_key
Value	string	否	标签 value	my_value
ResourceGroupId	string	否	资源组 ID	rg-acfmywpvugkh7kq

返回参数

名称	类型	描述	示例值
	object
RequestId	string	Id of the request	4FD06DF0-9167-5C6F-A145-F30CA4A15D54
NextToken	string	本次调用返回的查询凭证值。	563d42ae0b17572449ec8c97f7f66069
HyperNodes	array<object>	节点列表
	array<object>
CreateTime	string	创建时间	2025-07-07T17:38:35.391
ExpireTime	string	机器过期时间	2025-04-19T02:32:48Z
MachineType	string	机型	efg2.NH2cn
NodeGroupId	string	节点组 id	i123229811742436895560
NodeGroupName	string	节点组名称	g1
HyperNodeId	string	节点 id	e01-cn-2r42tmj4z02
ZoneId	string	可用区 id	cn-shanghai-b
HpnZone	string	集群编号	B1
VpcId	string	专有网络 ID	vpc-0jl8gs7qmx89739e210dn
VSwitchId	string	专有网络交换机 ID	vsw-bp1u4ej4ap8c4yiqfi87c
Tags	array<object>	标签信息
	object	标签信息
Key	string	标签 key	key1
Value	string	标签值。	ali-zeekr-ota-doris-prod-hz-selectdb
TaskId	string	任务 ID	i153907661745288876128
CommodityCode	string	商品码	bccluster_eflocomputing_public_cn
FileSystemMountEnabled	boolean	是否支持文件存储挂载	False
Status	string	节点状态	Extending
Hostname	string		alywlcb-lingjun-gpu-0025

示例

正常返回示例

JSON格式

{
  "RequestId": "4FD06DF0-9167-5C6F-A145-F30CA4A15D54",
  "NextToken": "563d42ae0b17572449ec8c97f7f66069",
  "HyperNodes": [
    {
      "CreateTime": "2025-07-07T17:38:35.391",
      "ExpireTime": "2025-04-19T02:32:48Z",
      "MachineType": "efg2.NH2cn",
      "NodeGroupId": "i123229811742436895560",
      "NodeGroupName": "g1",
      "HyperNodeId": "e01-cn-2r42tmj4z02",
      "ZoneId": "cn-shanghai-b",
      "HpnZone": "B1",
      "VpcId": "vpc-0jl8gs7qmx89739e210dn",
      "VSwitchId": "vsw-bp1u4ej4ap8c4yiqfi87c",
      "Tags": [
        {
          "Key": "key1",
          "Value": "ali-zeekr-ota-doris-prod-hz-selectdb"
        }
      ],
      "TaskId": "i153907661745288876128",
      "CommodityCode": "bccluster_eflocomputing_public_cn",
      "FileSystemMountEnabled": true,
      "Status": "Extending",
      "Hostname": "alywlcb-lingjun-gpu-0025"
    }
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。