安装合约 - InstallContractNew

功能介绍

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

授权信息

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

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

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID
instance_id	是	String	实例ID

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token

表3 FormData参数
参数	是否必选	参数类型	描述
name	是	String	合约名称，支持小写字母和数字，必须以小写字母开头
version	是	String	合约版本号，支持小写字母、数字、点和下划线，必须以小写字母或数字开头，数字结尾，且不能包含连续两个点或者下划线，也不能包含点和下划线相邻
type	是	String	合约类型：Go语言类型（go）、Solidity语言类型(solidity)、Java语言类型(java)
install_orgs	是	String	合约安装的组织ID列表，合约类型为solidity时该字段可不填写
endorse_orgs	是	String	合约背书的组织ID列表，合约类型为solidity时该字段可不填写
endorse_policy	是	String	合约背书策略：任意组织背书（OR）、全部组织背书（AND），合约类型为soildity的时候背书策略只能为任意组织背书
file	是	File	合约ZIP文件。当前只支持Go和java语言类型合约，只能上传一个zip文件。go语言类型合约，zip文件不能超过30M，子文件总数不能超过1000000个，子文件总大小不能超过500M。java语言类型合约，zip文件不能超过100M，子文件只能是以contract.jar为名称的jar包，jar包不能超过100M。
description	否	String	合约描述
security_check	否	String	是否开启合约安全检查任务；true表示开启，其它值表示不开启；当前只支持Go语言类型合约
byte_code	否	String	Solidity合约字节码内容

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
result	String	操作结果，值固定为success

状态码：400

表5 响应Body参数
参数	参数类型	描述
code	String	状态码
error_code	String	错误码
error_msg	String	错误信息
message	String	错误详细信息

状态码：401

表6 响应Body参数
参数	参数类型	描述
code	String	状态码
error_code	String	错误码
error_msg	String	错误信息
message	String	错误详细信息

状态码：500

表7 响应Body参数
参数	参数类型	描述
code	String	状态码
error_code	String	错误码
error_msg	String	错误信息
message	String	错误详细信息

请求示例

{
  "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"
}