文档首页/ 灵衢智算集群 AICS/ API参考/ API/ 节点/ 查询节点服务器-ShowNode
更新时间:2026-10-20 GMT+08:00
分享

查询节点服务器-ShowNode

功能介绍

根据节点ID查询节点服务器详情,注意:如果节点status_reason不为空,说明节点对应操作失败

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

aics:node:get

Read

node *

g:ResourceTag/<tag-key>

-

eip:publicIps:list

hypernode

g:ResourceTag/<tag-key>

-

aics:HypernodeRelated

URI

GET /v2/{project_id}/nodes/{node_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

node_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}。

默认取值 :

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

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)。

metadata

Array of Metadata objects

参数解释:

节点元数据。

取值范围:

不涉及。

表4 NodeNetworkInterface

参数

参数类型

描述

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信息。

取值范围 :

不涉及。

表5 public_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。

表6 market_info

参数

参数类型

描述

charging_mode

String

参数解释:

付费类型。

取值范围:

  • prePaid:包周期付费。

  • postPaid: 按需付费。

order_id

String

参数解释 :

订单ID。

取值范围 :

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

表7 ProviderResourceInfo

参数

参数类型

描述

instance_type

String

参数解释:

节点服务器类型。

取值范围:

  • ECS:云服务器。

instance_id

String

参数解释 :

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

取值范围 :

不涉及。

表8 Volume

参数

参数类型

描述

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}。

表9 TagKv

参数

参数类型

描述

key

String

参数解释:

标签键。

取值范围:

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

value

String

参数解释:

标签值。

取值范围:

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

表10 Metadata

参数

参数类型

描述

key

String

参数解释:

元数据键。

取值范围:

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

value

String

参数解释:

元数据值。

取值范围:

长度0-200。

请求示例

查询节点详细信息请求示例。使用场景:用户根据节点ID查询详细信息。

GET https://{endpoint}/v2/0605767a3300d5762fb7c0186d9e1779/nodes/a1b2c3d4-e5f6-7890-abcd-ef1234567890

响应示例

状态码:200

{
  "id" : "a1b2c3d4-e5f6-4890-abcd-ef1234567890",
  "name" : "node-example",
  "node_type" : "c7.large.2",
  "keypair_name" : "my-keypair",
  "availability_zone_id" : "cn-north-4a",
  "cluster_id" : "12345678-1234-1234-1234-123456789abc",
  "hyper_group_id" : "23456789-2345-2345-2345-234567890bcd",
  "hypernode_id" : "34567890-3456-3456-a456-345678901cde",
  "status" : "RUNNING",
  "frozen_status" : [ ],
  "network_interfaces" : [ {
    "vpc_id" : "3b6f1234-5a7b-8c9d-0e1f-2a3b4c5d6e7f",
    "subnet_id" : "4c7e2345-6b8c-9d0e-1f2a-3b4c5d6e7f8a",
    "port_id" : "port-12345678",
    "is_primary" : true,
    "public_ip" : {
      "id" : "e8a76543-2b1c-4d3e-9f8a-7b6c5d4e3f2a",
      "ip_address" : "123.123.123.123"
    }
  } ],
  "market_info" : {
    "charging_mode" : "prePaid",
    "order_id" : "CS21090912345678"
  },
  "created_at" : "2024-01-01T00:00:00.000+08:00",
  "updated_at" : "2024-01-01T00:00:00.000+08:00",
  "provider_resource_info" : {
    "instance_type" : "ECS",
    "instance_id" : "45678901-4567-4567-a567-456789012def"
  },
  "volumes" : [ {
    "size" : 40,
    "is_root" : true,
    "volume_type" : "SSD",
    "volume_id" : "56789012-5678-5678-a678-567890123efa"
  } ],
  "image_id" : "67890123-6789-6789-6789-678901234fab"
}

状态码

状态码

描述

200

查询成功,返回节点实例信息

错误码

请参见错误码。

相关文档