文档首页/ Web3节点引擎服务 NES/ API参考/ API/ 专享版/ 节点管理/ 查询单个节点
更新时间：2024-01-31 GMT+08:00
查看PDF
分享

查询单个节点

功能介绍

查询单个节点详情

URI

GET /v1/{project_id}/node-provider/nodes/{node_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

最小长度：32

最大长度：32

node_id

是

String

节点ID

最小长度：36

最大长度：45

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token

最小长度：1

最大长度：65535

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

id

String

节点ID

最小长度：36

最大长度：45

ws_address

String

websocket终端地址

最小长度：0

最大长度：100

http_address

String

http终端地址

最小长度：0

最大长度：100

grpc_address

String

gRPC终端地址

最小长度：0

最大长度：100

validator_http_address

String

validator http终端地址

最小长度：0

最大长度：100

flavor

MachineFlavor object

节点规格

status

String

节点状态（Available,Unavailable,Creating,Upgrading）

最小长度：0

最大长度：100

network_type

NetworkType object

节点网络信息

node_type

String

节点类型（全节点:Full node或支持质押节点:Full node (Staking supported)）

最小长度：0

最大长度：100

high_availability

Boolean

是否高可用

create_time

String

节点创建时间

最小长度：0

最大长度：100

mev_info

MevInfo object

MEV信息

ethereum_client_info

EthereumClientInfo object

以太坊客户端信息

validator_interface_info

ValidatorInterfaceInfo object

质押节点Validator非必需接口信息

eps_info

Object

企业项目信息
表4 MachineFlavor

参数

参数类型

描述

cpu

Integer

cpu核数

最小值：1

最大值：1024

ram

Integer

内存

最小值：1

最大值：1048576

description

String

描述信息（功能测试:Test,开发首选:Preferred,稳定运行:Stable,强劲性能:Powerful）

最小长度：1

最大长度：50

azs

Array of strings

节点可用区信息

数组长度：0 - 100
表5 NetworkType

参数

参数类型

描述

id

String

网络类型ID

最小长度：0

最大长度：1000

framework

String

公链名称

最小长度：0

最大长度：1000

name

String

网络名称

最小长度：0

最大长度：1000
表6 MevInfo

参数

参数类型

描述

relays

Array of strings

new relays

最小长度：0

最大长度：100

数组长度：0 - 100

enable

Boolean

是否开启MEV

最小长度：1

最大长度：5

version

String

Mev-Boost版本

最小长度：1

最大长度：64
表7 EthereumClientInfo

参数

参数类型

描述

execution_client_type

String

以太坊执行层客户端类型

最小长度：0

最大长度：1000

execution_client_version

String

以太坊执行层客户端版本

最小长度：0

最大长度：1000

consensus_client_type

String

以太坊共识层客户端类型

最小长度：0

最大长度：1000

consensus_client_version

String

以太坊共识层客户端版本

最小长度：0

最大长度：1000
表8 ValidatorInterfaceInfo

参数

参数类型

描述

allow_update

Boolean

是否允许打开/关闭质押节点Validator非必需接口

最小长度：1

最大长度：5

is_nonrequired_validator_api_open

Boolean

当前质押节点Validator非必需接口是否打开

最小长度：1

最大长度：5

状态码： 400

表9 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

状态码： 401

表10 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

状态码： 500

表11 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

请求示例

无

响应示例

状态码： 200

请求成功

{
  "id" : "468eda20-040b-11ee-877d-fa163e6c5c60",
  "ws_address" : "ws://100.100.100.100",
  "http_address" : "http://100.100.100.100",
  "grpc_address" : "100.100.100.100:30002",
  "validator_http_address" : "100.100.100.100:30003",
  "eps_info" : {
    "eps_id" : 0,
    "eps_name" : "default"
  },
  "flavor" : {
    "cpu" : 2,
    "ram" : 8196,
    "description" : "Preferred",
    "azs" : [ "ap-southeast-3a" ]
  },
  "status" : "Available",
  "network_type" : {
    "id" : "79d0f3b9-8ce1-11ed-8398-0242a9fe1e02",
    "framework" : "Ethereum",
    "name" : "Goerli"
  },
  "node_type" : "Full node",
  "high_availability" : false,
  "create_time" : "2023-06-06T09:41:37.000553+08:00",
  "mev_info" : {
    "relays" : [ "https://0xa15b52576bcbf1072f4a011c0f99f9fb6c66f3e1ff321f11f461d15e31b1cb359caa092c71bbded0bae5b5ea401aab7e@aestus.live", "https://0xa7ab7a996c8584251c8f925da3170bdfd6ebc75d50f5ddc4050a6fdc77f2a3b5fce2cc750d0865e05d7228af97d69561@agnostic-relay.net" ],
    "enable" : true,
    "version" : "v1.6.0"
  },
  "ethereum_client_info" : {
    "execution_client_type" : "Geth",
    "execution_client_version" : "v1.11.6",
    "consensus_client_type" : "Prysm",
    "consensus_client_version" : "v4.0.6"
  },
  "validator_interface_info" : {
    "allow_update" : false,
    "is_nonrequired_validator_api_open" : false
  }
}

状态码： 400

请求参数校验不通过

{
  "code" : 400,
  "error_code" : "BCS.03400001",
  "error_msg" : "Invalid request.",
  "message" : "unmarshal request data error"
}

状态码： 401

鉴权失败

{
  "code" : 401,
  "error_code" : "BCS.03401001",
  "error_msg" : "Authorization failed.",
  "message" : "request token is not valid"
}

状态码： 500

服务内部执行错误

{
  "code" : 500,
  "error_code" : "BCS.03500001",
  "error_msg" : "Internal error.",
  "message" : "project [xxx] node [xxx] get service bearer user token error"
}

状态码

状态码

描述

200

请求成功

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误

错误码

请参见错误码。

父主题： 节点管理