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

查询合约列表 - ListBesuContracts

功能介绍

查询合约列表，单次最多查询500个，只支持云端管理实例使用

授权信息

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

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

URI

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

表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

合约数量

contracts

Array of BesuContractsRes objects

合约信息
表5 BesuContractsRes

参数

参数类型

描述

address

String

合约地址

status

String

合约状态

abi

String

合约ABI

bytecode

String

合约字节码

description

String

实体文字描述的一个或多个段落。

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,
  "contracts" : [ {
    "address" : "string",
    "status" : "string",
    "abi" : "string",
    "bytecode" : "string",
    "description" : "string",
    "create_time" : "string"
  } ]
}

状态码

状态码

描述

200

请求成功

400

请求参数校验不通过

401

鉴权失败

500

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

相关文档