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

查询区块列表 - ListBesuBlocks

功能介绍

查询区块列表，逆序查询，单次查询限制500个，只支持云端管理实例使用

授权信息

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

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

URI

GET /v2/{project_id}/besu/instances/{instance_id}/chain/blocks

表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

区块总数量

blocks

Array of BesuBlockInfo objects

区块列表
表5 BesuBlockInfo

参数

参数类型

描述

block_height

String

区块高度

transaction_num

Integer

区块包含交易数量

body_hash

String

区块hash

parent_hash

String

父区块hash

create_time

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" : 0,
  "blocks" : [ {
    "block_height" : "string",
    "transaction_num" : 500,
    "body_hash" : "string",
    "parent_hash" : "string",
    "create_time" : "string"
  } ]
}

状态码

状态码

描述

200

请求成功

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误
父主题： besu

相关文档