区块链服务 BCS区块链服务 BCS

更新时间:2021/09/14 GMT+08:00
分享

创建联盟链

功能介绍

创建BCS服务实例

URI

POST /api/v1/consortiums

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

consortiumVersion

String

联盟链版本,Fabric,可设置为1.4或2.0

consortiumName

String

BCS服务名

cipherSuit

String

加密算法,BCS服务安全机制,可选:ECDSA(ECDSA),国密算法(sm2)

consensusAlgorithm

String

共识算法,BCS服务的共识策略,Fabric1.4版本可选:测试策略(solo)、快速拜占庭容错算法(SFLIC);Fabric2.0版本可选:raft共识算法(etcdraft)、快速拜占庭容错算法(SFLIC)

consensusNodeCount

String

共识(排序)节点数,可选:SFLIC算法传4,etcdraft算法传3,solo算法传1

resourceId

String

使用已有集群填集群id,参数填为空则新建集群并需同时传appChainInfo参数的cce_create_info,设置自定义集群规格

orgList

Array of OrgList objects

组织名、节点数信息

appChainInfo

CreateRequestBody object

BCS详细参数

表2 OrgList

参数

是否必选

参数类型

描述

orgId

String

组织名

nodeCount

String

节点数

表3 CreateRequestBody

参数

是否必选

参数类型

描述

blockchain_type

String

区块链类型,默认私有链,可选:联盟链(union),私有链(private)

org_disk_size

Integer

节点组织存储容量节点组织存储容量GB,至少为100GB

database_type

String

BCS服务数据库类型,包括文件数据库(goleveldb),NoSQL(couchdb),选择couchdb需要填写couchdb_info字段中的信息

resource_password

String

BCS服务资源、区块链管理密码,如不填自动生成

use_eip

Boolean

是否使用集群节点弹性IP

bandwidth_size

Integer

弹性IP带宽

cluster_type

String

集群类型,可选:CCE集群(cce)

cce_create_info

CCECreateInfo object

创建新集群需要填写cce_create_info字段中的信息

channels

Array of ChannelInfoV2 objects

通道列表

couchdb_info

CouchDbInfo object

couchDB信息

block_info

block_info object

区块生成配置信息

is_invitee

Boolean

是否是创建被邀请方实例,创建被邀请方实例需要同时填写invitor_infos字段中的信息

invitor_infos

InvitorInfos object

邀请方信息

表4 CCECreateInfo

参数

是否必选

参数类型

描述

node_num

Integer

集群节点数

node_flavor

String

集群节点规格,各局点不同,可在cce集群页面获取支持得节点规格,填写为"节点规格名.linux",如Si1.xlarge.4.linux

cce_flavor

String

CCE集群规格,可在cce集群页面获取集群规格,如cce.s1.small

init_node_pwd

String

节点初始密码,加盐加密,可详细参考https://support.huaweicloud.com/bestpractice-cce/cce_bestpractice_0058.html

az

String

可用区,可在cce集群页面获取可用区,一般为域名+字母,如cn-north-7a,cn-north-7为域名,可用区1对应a

cluster_platform_type

String

集群CPU架构类型:X86(VirtualMachine),ARM(ARM64)

表5 ChannelInfoV2

参数

是否必选

参数类型

描述

name

String

通道名

org_names

Array of strings

通道中组织名

description

String

通道描述

表6 CouchDbInfo

参数

是否必选

参数类型

描述

user_name

String

couchDB用户名

password

String

couchDB密码

表7 block_info

参数

是否必选

参数类型

描述

batch_timeout

Integer

区块产生时间(单位:秒),默认2秒

max_message_count

Integer

区块包含交易数量,默认500

表8 InvitorInfos

参数

是否必选

参数类型

描述

tenant_id

String

邀请方租户ID

project_id

String

邀请方项目ID

blockchain_id

String

邀请方服务实例ID

响应参数

状态码: 200

表9 响应Body参数

参数

参数类型

描述

consortiumId

String

服务实例id

opId

String

操作记录id

状态码: 400

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_message

String

错误描述

请求示例

{
  "consortiumVersion" : "2.0",
  "consortiumName" : "bcs-test",
  "cipherSuit" : "ECDSA",
  "consensusNodeCount" : "2",
  "consensusAlgorithm" : "etcdraft",
  "orgList" : [ {
    "orgId" : "org1",
    "nodeCount" : "2"
  } ],
  "resourceId" : "c5265392-9785-11eb-80d0-0255ac1001bc"
}

响应示例

状态码: 200

新服务实例信息

{
  "consortiumId" : "12691561-a50d-5207-6041-7346c90d4499",
  "opId" : "BCSSVC01-03-1617158790255323683"
}

状态码: 400

Bad Request

{
  "error_code" : "BCS.4006005",
  "error_msg" : "keyType error, keyType: blok not supported"
}

状态码

状态码

描述

200

新服务实例信息

400

Bad Request

错误码

请参见错误码

分享:

    相关文档

    相关产品