更新时间:2023-08-21 GMT+08:00
分享

查询合约列表

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

最小长度:32

最大长度:32

instance_id

String

实例ID

最小长度:36

最大长度:36

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

分页查询起始位置

最小值:0

limit

Integer

每页返回的条目数量

最小值:1

最大值:500

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

最小长度:1

最大长度:65535

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

count

Integer

合约总数量

最小值:0

最大值:100

contracts

Array of ContractInfo objects

合约列表

数组长度:0 - 100

表5 ContractInfo

参数

参数类型

描述

name

String

合约名称

version

String

合约版本号

最小长度:2

最大长度:14

type

String

合约类型:Go语言类型(go)、Solidity语言类型(solidity)、Java语言类型(java)

枚举值:

  • go

  • solidity

  • java

status

String

合约状态:安装中(Installing)、安装失败(Failed)、安装完成(Success)

枚举值:

  • Installing

  • Failed

  • Success

failed_message

String

合约安装失败详细错误信息

description

String

合约描述

chain_id

String

合约所属链ID

install_orgs

Array of strings

合约安装组织

数组长度:1 - 1000

endorse_orgs

Array of strings

合约背书组织

数组长度:1 - 1000

endorse_policy

String

合约背书策略:任意组织背书(OR)、全部组织背书(AND)

枚举值:

  • OR

  • AND

file_hash_code

String

合约文件SHA256哈希值

最小长度:64

最大长度:64

security_check

Boolean

合约是否开启安全检查任务

security_check_status

Integer

合约安全检查任务状态:不存在(0)、正在执行(1)、完成(2)、失败(3)

最小值:0

最大值:3

install_time

String

合约安装时间

状态码: 400

表6 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:1

最大长度:65535

状态码: 401

表7 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:1

最大长度:65535

状态码: 500

表8 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:1

最大长度:65535

请求示例

响应示例

状态码: 200

请求成功

{
  "count" : 1,
  "contracts" : [ {
    "name" : "test01",
    "version" : "1.0",
    "type" : "go",
    "status" : "Success",
    "description" : "",
    "failed_message" : "",
    "chain_id" : "default",
    "install_orgs" : [ "organization" ],
    "endorse_orgs" : [ "organization" ],
    "endorse_policy" : "OR",
    "file_hash_code" : "da366b9aac3fee0a54888f5d5ad94b4f57468fc43ecd29ffa2ec3b1e367bd35b",
    "security_check" : true,
    "security_check_status" : 2,
    "install_time" : "2022-04-29T01:30:50Z"
  } ]
}

状态码

状态码

描述

200

请求成功

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误

分享:

    相关文档

    相关产品