查询用户节点列表-ListNodes

aics:node:list

List

node *

-

-

eip:publicIps:list

hypernode

-

-

• g:RequestTag/<tag-key>

• g:TagKeys

• aics:HypernodeRelated

project_id

是

String

参数解释:

项目ID，获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

limit

否

Integer

参数解释:

分页查询单页记录数量。

约束限制:

不涉及。

取值范围:

1~100。

默认取值:

20。

marker

否

String

参数解释:

分页标记，本次请求获取该标记后的资源，base64编码。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

cluster_id

否

String

参数解释:

集群唯一标识UUID。

约束限制:

不涉及。

取值范围:

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

默认取值:

不涉及。

hyper_group_id

否

String

参数解释:

超节点组唯一标识UUID。

约束限制:

不涉及。

取值范围:

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

默认取值:

不涉及。

hypernode_id

否

String

参数解释:

超节点唯一标识UUID。

约束限制:

不涉及。

取值范围:

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

默认取值:

不涉及。

hypernode_ids

否

Array of strings

参数解释:

超节点ID列表，按指定超节点ID批量搜索。

约束限制:

与hypernode_id（单值）互斥，同时传入返回400。传空数组（[]）返回400 Bad Request。

取值范围:

1~100个超节点ID。

默认取值:

不涉及。

node_ids

否

Array of strings

参数解释:

节点ID列表，按指定节点ID批量搜索。

约束限制:

与node_id（单值）互斥，同时传入返回400。传空数组（[]）返回400 Bad Request。

取值范围:

1~100个节点ID。

默认取值:

不涉及。

node_type

否

String

参数解释 :

节点规格。

约束限制 :

不涉及。

取值范围 :

长度1-64，只能由英文字母、数字及"_"、"-"、"."组成。

默认取值 :

不涉及。

name

否

String

参数解释 :

节点名称。

约束限制 :

不涉及。

取值范围 :

长度1-128，只能由英文字母、数字及"_"、"-"、"."组成。

默认取值 :

不涉及。

availability_zone_id

否

String

参数解释 :

节点所属可用区。

约束限制 :

不涉及。

取值范围 :

长度1-128，只能由英文字母、数字及"_"、"-"、"."组成。

默认取值 :

不涉及。

status

否

String

参数解释 :

节点状态。

约束限制 :

不涉及。

取值范围:

• PROVISIONING：节点发放中。

• RUNNING：节点运行中。

• STOPPING：节点停止中。

• TERMINATING：节点删除中。

• STOPPED：节点已停止。

• STARTING：节点启动中。

• ERROR：错误，需要运维人员干预。

• REBOOTING：节点重启中。

• REIMAGING：节点切换镜像中。

• REINSTALLING：节点重装中。

• REDEPLOYING：节点重部署中。

默认取值:

不涉及。

tags

否

Array of strings

参数解释 :

节点标签，格式为tags=key,value&tags=key1,value1。

约束限制 :

1~20个。

取值范围 :

不涉及。

默认取值 :

不涉及。

arch

否

String

参数解释:

CPU架构，按指定架构过滤资源。

约束限制:

不涉及。

取值范围:

cpu架构类型枚举值：ARM。

默认取值:

不涉及。

generation

否

String

参数解释:

规格代次，按指定代次过滤资源。

约束限制:

不涉及。

取值范围:

规格（芯片）代次枚举值：A5（Ascend5）。

默认取值:

不涉及。

node_category

否

String

参数解释:

节点类别，默认所有均查询。

约束限制:

不涉及。

取值范围:

• NODE: 单节点（非超节点下节点）。

• HYPERNODE_NODE: 超节点下的节点。

默认取值:

不涉及。

X-Auth-Token

否

String

参数解释:

用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

nodes

Array of NodeResponseBody objects

参数解释 :

节点实例列表。

取值范围 :

不涉及。

page_info

PageInfo object

参数解释:

分页信息。

取值范围:

不涉及。

id

String

参数解释 :

节点ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

name

String

参数解释 :

实例名称。

取值范围 :

长度1-64，只能由英文字母、数字及"_"、"-"、"."组成。

node_type

String

参数解释 :

节点规格ID。

取值范围 :

长度1-128。

keypair_name

String

参数解释 :

密钥对名称。

取值范围 :

长度1-64，只能由英文字母、数字及"_"、"-"、"."组成。

availability_zone_id

String

参数解释 :

可用区信息。

取值范围 :

只能由英文字母、数字及"_"、"-"、"."组成。

cluster_id

String

参数解释 :

集群ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

hyper_group_id

String

参数解释 :

超节点组ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

hypernode_id

String

参数解释 :

服务器所属的超节点资源ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

status

String

参数解释:

节点状态。

取值范围:

• PROVISIONING：节点发放中。

• RUNNING：节点运行中。

• STOPPING：节点停止中。

• TERMINATING：节点删除中。

• TERMINATED：节点已删除。

• STOPPED：节点已停止。

• STARTING：节点启动中。

• ERROR：错误，需要运维人员干预。

• REBOOTING：节点重启中。

• REIMAGING：节点切换镜像中。

• REINSTALLING：节点重装中。

• REDEPLOYING：节点重部署中。

status_reason

String

参数解释 :

节点处于中间态或错误状态时的原因说明，正常状态时为空。

取值范围 :

最长256字符。

frozen_status

Array of strings

参数解释:

冻结状态，非冻结状态时此状态值为空。

取值范围:

• ARREAR,DELETABLE：处于欠费冻结可删除状态。

• POLICE,UNDELETABLE：处于公安冻结不可删除状态。

• ILLEGAL,DELETABLE：处于违规冻结可删除状态。

network_interfaces

Array of NodeNetworkInterface objects

参数解释 :

VPC网口信息。

取值范围 :

不涉及。

market_info

market_info object

参数解释 :

计费信息。

取值范围 :

不涉及。

created_at

String

参数解释:

资源或操作的创建时间。

取值范围:

格式为yyyy-MM-dd'T'HH:mm:ss.SSSXXX。例如：2026-05-22T06:30:45.123Z。

updated_at

String

参数解释:

资源或操作的更新时间。

取值范围:

格式为yyyy-MM-dd'T'HH:mm:ss.SSSXXX。例如：2026-05-22T06:30:45.123Z。

provider_resource_info

ProviderResourceInfo object

参数解释 :

底层资源信息。

取值范围 :

不涉及。

volumes

Array of Volume objects

参数解释 :

节点服务器磁盘信息。

取值范围 :

不涉及。

tags

Array of TagKv objects

参数解释 :

租户标签。

取值范围 :

不涉及。

image_id

String

参数解释 :

服务器镜像ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

slice_index

Integer

参数解释:

超节点下节点的切片索引id，相同的索引id表示节点在同一个切片内。

取值范围:

不涉及。

arch

String

参数解释:

CPU架构类型。

取值范围:

cpu架构类型枚举值：ARM。

generation

String

参数解释:

规格代次，表示超节点、节点的芯片代次。

取值范围:

规格（芯片）代次枚举值：A5（Ascend5）。

vpc_id

String

参数解释 :

服务器所在虚拟私有云ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

subnet_id

String

参数解释 :

子网ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

port_id

String

参数解释 :

网卡ID。

取值范围 :

长度1-128。

is_primary

Boolean

参数解释 :

是否主网卡。

取值范围 :

• true

• false

uboe_enable

Boolean

参数解释 :

是否启用UBoE。

取值范围 :

• true

• false

public_ip

public_ip object

参数解释 :

弹性公网IP信息。

取值范围 :

不涉及。

id

String

参数解释 :

弹性公网IP ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

ip_address

String

参数解释 :

弹性公网IP地址。

取值范围 :

长度1-128。

charging_mode

String

参数解释:

付费类型。

取值范围:

• prePaid：包周期付费。

• postPaid: 按需付费。

order_id

String

参数解释 :

订单ID。

取值范围 :

长度1-128，只能由英文字母、数字及"_"、"-"、"."组成。

instance_type

String

参数解释:

节点服务器类型。

取值范围:

• ECS：云服务器。

instance_id

String

参数解释 :

服务器所属的HPS对应的ECS资源ID。

取值范围 :

不涉及。

size

Integer

参数解释 :

EVS盘大小，单位GB。

取值范围 :

1~32768。

is_root

Boolean

参数解释 :

是否系统盘。

取值范围 :

• true

• false

is_bind

Boolean

参数解释 :

磁盘是否为创建时强绑定的磁盘，强绑定的磁盘不允许卸载。

取值范围 :

• true：强绑定的磁盘，不允许卸载

• false：非强绑定的磁盘，允许卸载

volume_type

String

参数解释 :

EVS盘类型。

取值范围 :

不涉及。

volume_id

String

参数解释 :

EVS盘的ID。

取值范围 :

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

key

String

参数解释:

标签键。

取值范围:

最大128个Unicode字符。只能由大小写字母、数字、中文、空格及"_"、"-"、"."、":"、"/"、"="、"+"、"@"组成。

value

String

参数解释:

标签值。

取值范围:

最大255个Unicode字符。只能由大小写字母、数字、中文、空格及"_"、"-"、"."、":"、"/"、"="、"+"、"@"、"&"组成。

next_marker

String

参数解释:

以单页最后一条资源标识作为分页标记，base64编码。用于请求下一页使用的分页标记。

取值范围:

不涉及。

current_count

Integer

参数解释 :

当前查询结果数量。

取值范围 :

不涉及。

200

查询成功，返回节点实例列表