# 查询节点服务器-ShowNode
#### 功能介绍
根据节点ID查询节点服务器详情，注意：如果节点status_reason不为空，说明节点对应操作失败
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/AICS/doc?api=ShowNode)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-aics/aics_05_0700.html)。
| 授权项           | 访问级别 | 资源类型（\*为必须） | 条件键                       | 别名 | 依赖的授权项             |
|:---|:---|:---|:---|:---|:---|
| aics:node:get | Read | node \*     | g:ResourceTag/\<tag-key\> | -  | eip:publicIps:list |
| aics:node:get | Read | hypernode   | g:ResourceTag/\<tag-key\> | -  | eip:publicIps:list |
   
#### URI
GET /v2/{project_id}/nodes/{node_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**: 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-aics/aics_api_0702.html)。 **约束限制**: 不涉及。 **取值范围**: 不涉及。 **默认取值**: 不涉及。                 |
| 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。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| name                   | String                                                                    | **参数解释** : 实例名称。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| node_type              | String                                                                    | **参数解释** : 节点规格ID。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| keypair_name           | String                                                                    | **参数解释** : 密钥对名称。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| availability_zone_id   | String                                                                    | **参数解释** : 可用区信息。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| cluster_id             | String                                                                    | **参数解释** : 集群ID。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| hyper_group_id         | String                                                                    | **参数解释** : 超节点组ID。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| hypernode_id           | String                                                                    | **参数解释** : 服务器所属的超节点资源ID。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| status                 | String                                                                    | **参数解释**: 节点状态。 **取值范围**: - PROVISIONING：节点发放中。   - RUNNING：节点运行中。   - STOPPING：节点停止中。   - TERMINATING：节点删除中。   - TERMINATED：节点已删除。   - STOPPED：节点已停止。   - STARTING：节点启动中。   - ERROR：错误，需要运维人员干预。   - REBOOTING：节点重启中。   - REIMAGING：节点切换镜像中。   - REINSTALLING：节点重装中。   - REDEPLOYING：节点重部署中。    |
| status_reason          | String                                                                    | **参数解释** : 节点处于中间态或错误状态时的原因说明，正常状态时为空。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| frozen_status          | Array of strings                                                          | **参数解释**: 冻结状态，非冻结状态时此状态值为空。 **取值范围**: - ARREAR,DELETABLE：处于欠费冻结可删除状态。   - POLICE,UNDELETABLE：处于公安冻结不可删除状态。   - ILLEGAL,DELETABLE：处于违规冻结可删除状态。   - VERIFY,DELETABLE：处于未实名冻结可删除状态。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| network_interfaces     | Array of [NetworkInterface] 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。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
 表4NetworkInterface 
| 参数          | 参数类型                                              | 描述                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| vpc_id      | String                                            | **参数解释** : 服务器所在虚拟私有云ID。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                |
| subnet_id   | String                                            | **参数解释** : 子网ID。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                        |
| port_id     | String                                            | **参数解释** : 网卡ID。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                        |
| is_primary  | Boolean                                           | **参数解释** : 是否主网卡。 **取值范围** : - true   - false       |
| uboe_enable | Boolean                                           | **参数解释** : 是否启用UBOE。 **取值范围** : - true   - false    |
| public_ip   | [public_ip] object | **参数解释** : 弹性公网IP信息。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                    |
   
 表5public_ip 
| 参数         | 参数类型   | 描述                                                                                                                        |
|:---|:---|:---|
| id         | String | **参数解释** : 弹性公网IP ID。 **取值范围** : 不涉及。 |
| ip_address | String | **参数解释** : 弹性公网IP地址。 **取值范围** : 不涉及。  |
   
 表6market_info 
| 参数            | 参数类型   | 描述                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| charging_mode | String | **参数解释**: 付费类型。 **取值范围**: - prePaid：包周期付费。    |
| order_id      | String | **参数解释** : 订单ID。 **取值范围** : 不涉及。                                                                                                                                                |
   
 表7ProviderResourceInfo 
| 参数            | 参数类型   | 描述                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| instance_type | String | **参数解释**: 节点服务器类型。 **取值范围**: - ECS：云服务器。    |
| instance_id   | String | **参数解释** : 服务器所属的HPS对应的ECS资源ID。 **取值范围** : 不涉及。                                                                                                                               |
   
 表8Volume 
| 参数          | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| size        | Integer | **参数解释** : EVS盘大小。 **取值范围** : 1\~32768。                                                                                                                                                                                                                                                                                                                             |
| is_root     | Boolean | **参数解释** : 是否系统盘。 **取值范围** : - true   - false                                                   |
| is_bind     | Boolean | **参数解释** : 磁盘是否为创建时强绑定的磁盘，强绑定的磁盘不允许卸载。 **取值范围** : - true：强绑定的磁盘，不允许卸载   - false：非强绑定的磁盘，允许卸载    |
| volume_type | String  | **参数解释** : EVS盘类型。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                  |
| volume_id   | String  | **参数解释** : EVS盘的ID。 **取值范围** : 不涉及。                                                                                                                                                                                                                                                                                                                                 |
   
 表9TagKv 
| 参数    | 参数类型   | 描述                                                                                                                                                                                               |
|:---|:---|:---|
| key   | String | **参数解释**: 标签键。 **取值范围**: 最大128个Unicode字符。满足'\^((?!\\s)(?!_sys_)\[\\p{L}\\p{Z}\\p{N}_.:/=+-@\]\*)(?\<!\\s)$'。 |
| value | String | **参数解释**: 标签值。 **取值范围**: 最大255个Unicode字符。满足'\^(\[\\p{L}\\p{Z}\\p{N}_.:/=+-@\]\*)$'。                          |
   
#### 请求示例
查询节点详细信息请求示例。使用场景：用户根据节点ID查询详细信息。
```
GET https://{endpoint}/v2/0605767a3300d5762fb7c0186d9e1779/nodes/a1b2c3d4-e5f6-7890-abcd-ef1234567890
```
#### 响应示例
**状态码：200**
查询成功，返回节点实例信息
ShowNode成功响应示例
```
{
  "id" : "a1b2c3d4-e5f6-7890-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-3456-345678901cde",
  "status" : "RUNNING",
  "frozen_status" : [ ],
  "network_interfaces" : [ {
    "vpc_id" : "vpc-12345678",
    "subnet_id" : "subnet-12345678",
    "port_id" : "port-12345678",
    "is_primary" : true,
    "public_ip" : {
      "id" : "eip-12345678",
      "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-4567-456789012def"
  },
  "volumes" : [ {
    "size" : 40,
    "is_root" : true,
    "volume_type" : "SSD",
    "volume_id" : "56789012-5678-5678-5678-567890123efa"
  } ],
  "image_id" : "67890123-6789-6789-6789-678901234fab"
}
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | 查询成功，返回节点实例信息 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-aics/ErrorCode.html)。
