文档首页/区块链服务 BCS/API参考/华为云区块链引擎管理/API(华为云区块链引擎)/终端节点管理/查询终端节点列表 - ListEndpoints
更新时间：2025-12-18 GMT+08:00
查看PDF
分享

查询终端节点列表 - ListEndpoints

功能介绍

查询终端节点列表，单次最多查询100个，只支持云端管理实例使用且只返回创建成功的终端节点

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v2/{project_id}/huaweicloudchain/instances/{instance_id}/endpoints

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

instance_id

是

String

实例ID

表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

分页查询起始位置

limit

否

Integer

每页返回的条目数量

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

count

Integer

终端节点总数

endpoints

Array of EndpointInfo objects

终端节点列表

表5 EndpointInfo

参数

参数类型

描述

id

String

36位uuid

name

String

交易状态

ip

String

交易状态

状态码：400

表6 响应Body参数

参数

参数类型

描述

code

String

状态码

error_code

String

错误码

error_msg

String

错误信息

message

String

错误详细信息

状态码：401

表7 响应Body参数

参数

参数类型

描述

code

String

状态码

error_code

String

错误码

error_msg

String

错误信息

message

String

错误详细信息

状态码：500

表8 响应Body参数

参数

参数类型

描述

code

String

状态码

error_code

String

错误码

error_msg

String

错误信息

message

String

错误详细信息

请求示例

无

响应示例

状态码：200

请求成功

{
  "count" : 1,
  "endpoints" : [ {
    "id" : "ec674773-2626-47df-b8c8-38e39c6ddeb8",
    "name" : "vpc-bcs-yyno.subnet-bcs-yjei.ec674773",
    "ip" : "x.x.x.x"
  } ]
}

状态码

状态码

描述

200

请求成功

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误

父主题：终端节点管理

相关文档