文档首页> 区块链服务 BCS> API参考(华为云区块链引擎-公测)> API(华为云区块链引擎)> 合约管理> 安装合约
更新时间：2023-08-21 GMT+08:00
查看PDF
分享

安装合约

功能介绍

安装或者更新合约，只支持云端管理实例使用

URI

POST /v2/{project_id}/huaweicloudchain/instances/{instance_id}/chain/contract

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

最小长度：32

最大长度：32

instance_id

是

String

实例ID

最小长度：36

最大长度：36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token

最小长度：1

最大长度：65535
表3 FormData参数

参数

是否必选

参数类型

描述

name

是

String

合约名称，支持小写字母和数字，必须以小写字母开头

最小长度：6

最大长度：25

version

是

String

合约版本号，支持小写字母、数字、点和下划线，必须以小写字母或数字开头，数字结尾，且不能包含连续两个点或者下划线，也不能包含点和下划线相邻

最小长度：2

最大长度：14

type

是

String

合约类型：Go语言类型（go）、Solidity语言类型(solidity)、Java语言类型(java)

枚举值：

  • go

  • solidity

  • java

install_orgs

是

String

合约安装的组织ID列表，合约类型为solidity时该字段可不填写

最小长度：10

最大长度：65535

endorse_orgs

是

String

合约背书的组织ID列表，合约类型为solidity时该字段可不填写

最小长度：10

最大长度：65535

endorse_policy

是

String

合约背书策略：任意组织背书（OR）、全部组织背书（AND），合约类型为soildity的时候背书策略只能为任意组织背书

枚举值：

  • OR

  • AND

file

是

File

合约ZIP文件。当前只支持Go和java语言类型合约，只能上传一个zip文件。go语言类型合约，zip文件不能超过30M，子文件总数不能超过1000000个，子文件总大小不能超过500M。java语言类型合约，zip文件不能超过100M，子文件只能是以contract.jar为名称的jar包，jar包不能超过100M。

description

否

String

合约描述

最小长度：0

最大长度：50

security_check

否

String

是否开启合约安全检查任务；true表示开启，其它值表示不开启；当前只支持Go语言类型合约

枚举值：

  • true

byte_code

否

String

Solidity合约字节码内容

最小长度：0

最大长度：512000

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

result

String

操作结果，值固定为success

最小长度：7

最大长度：7

状态码： 400

表5 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：1

最大长度：65535

状态码： 401

表6 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：1

最大长度：65535

状态码： 500

表7 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：1

最大长度：65535

请求示例

  • {
  "name" : "test01",
  "version" : "1.0",
  "type" : "solidity",
  "install_orgs" : "[\"org1-c0dx4mj1u\",\"org2-spogt1az5\"]",
  "endorse_orgs" : "[\"org1-c0dx4mj1u\",\"org2-spogt1az5\"]",
  "endorse_policy" : "OR",
  "byte_code" : "xxx"
}
  • {
  "name" : "test01",
  "version" : "1.0",
  "type" : "go",
  "install_orgs" : "[\"org1-c0dx4mj1u\",\"org2-spogt1az5\"]",
  "endorse_orgs" : "[\"org1-c0dx4mj1u\",\"org2-spogt1az5\"]",
  "endorse_policy" : "OR"
}

响应示例

状态码： 200

请求成功

{
  "result" : "success"
}

状态码

状态码

描述

200

请求成功

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误
父主题： 合约管理
分享：

    相关文档

    相关产品