更新时间:2023-03-27 GMT+08:00

安装链代码

功能介绍

在区块链节点上安装链代码,部分场景只支持go语言链码

URI

POST /v2/agent/apis/chaincode/install

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

表2 FormData参数

参数

是否必选

参数类型

描述

chaincode_name

String

链代码名称,以小写字母开头,支持小写字母和数字

最小长度:6

最大长度:25

chaincode_version

String

链代码版本,只允许使用数字、点(.)、横杠(-),必须以数字开头和结尾,且点和横杠不能相邻

最小长度:1

最大长度:14

target_peers

String

链代码安装Peer列表信息,例如:[{"org_id":"9fb42c91458763990a45b62af92546a21f168dae","org_name":"organization3","peer_id":"peer-9fb42c91458763990a45b62af92546a21f168dae-0.peer-9fb42c91458763990a45b62af92546a21f168dae.default.svc.cluster.local","peer_name":"peer-0"}]

description

String

链代码描述

chaincode_language

String

链代码编程语言,例如 golang

db_type

String

账本数据存储方式,请按照实例创建时的账本数据存储方式填写。例如 goleveldb,couchdb

security_check

String

链代码安全检查选项,目前只对golang语言链代码有效,true表示开启,false表示关闭,默认为false

file

File

链代码zip文件

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

total_peer_num

Integer

链代码操作Peer总数

success_peer_num

Integer

操作成功Peer数量

fail_peer_num

Integer

操作失败Peer数量

fail_peers

Array of strings

操作失败Peer信息

状态码: 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_message

String

错误描述

error_msg

String

错误描述

请求示例

POST https://192.168.0.90:30603/v2/agent/apis/chaincode/install

{chaincode_name:gochaincode3chaincode_version:2.0target_peers:[{"org_id":"9802af57cfab764dc12b860c44b01969575e83c9","org_name":"organization","peer_id":"peer-9802af57cfab764dc12b860c44b01969575e83c9-1.peer-9802af57cfab764dc12b860c44b01969575e83c9.default.svc.cluster.local","peer_name":"node-1"}]description:22222222chaincode_language:golangdb_type:goleveldbsecurity_check:true}

响应示例

状态码: 200

Success

{
  "total_peer_num" : 4,
  "success_peer_num" : 4,
  "fail_peer_num" : 0,
  "fail_peers" : [ ]
}

状态码: 400

Bad Request

{
  "error_code" : "BCS.4000013",
  "error_message" : "request body is too large"
}

状态码

状态码

描述

200

Success

400

Bad Request

错误码

请参见错误码