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

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

创建联盟

功能介绍

可以同时创建业务链

URI

POST /v1/ugbaas/unions

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

UID

String

联盟链UID

busiChains

Array of BusiChainCreation objects

BusiChain列表

creatorOrgID

String

联盟发起者已注册的组织ID

description

String

描述

invitation

Invitation object

Invitation is invitation struct

oemType

String

平台厂商类型,分为华为(HW)

orgs

Array of strings

联盟包含组织列表

unionID

String

联盟链ID

unionName

String

联盟名称

表2 BusiChainCreation

参数

是否必选

参数类型

描述

chainSpecs

Array of ChainSpec objects

联盟链规格,其中包含资源规格和区块链规格, 如果不提供则使用默认值

description

String

描述

id

String

业务链ID

name

String

业务链名称

orgIDs

Array of strings

业务链中包含的已注册的orgID列表

unionID

String

联盟ID

表3 ChainSpec

参数

是否必选

参数类型

描述

blockSpec

Array of BlockSpec objects

区块链节点规格。区块链规格元素数量与orgIDList中orgID对应。

infraSpec

InfraSpec object

InfraSpec is infrastructure struct

orgIDList

Array of strings

此资源中包含已注册的orgID列表,如果InfraSpec中没有指定OrgID, 则此列表中第一个orgID为资源提供者

表4 BlockSpec

参数

是否必选

参数类型

描述

OrderNum

Long

Order数量,取值范围为[4, 10]

PeerNum

Long

Peer背书节点数量,取值范围为[1, 5]

signAlgorithm

String

安全机制,可选:ECDSA(ECDSA),国密算法(sm2), 默认为sm2

表5 InfraSpec

参数

是否必选

参数类型

描述

Cpu

Long

cpu核数

Disk

Long

磁盘空间(GB)

Mem

Long

内存大小(GB)

NodeNum

Long

集群节点(VM)数目, 默认为1

anyExistingClusterIfNotMatch

String

当没有匹配到资源时,使用任意空闲资源,true/false, 默认为false(暂未实现)

az

String

available zone,可选参数,已知flavor时使用

clusterID

String

已经存在CCE集群ID,可选参数,已知可用集群时使用

clusterName

String

已经存在CCE集群名称,可选参数,已知可用集群时使用

clusterPlatformType

String

集群CPU架构类型,X86(VirtualMachine),ARM(ARM64),可选参数,默认为X86

flavor

String

flavor,可选参数,已知flavor时使用

initNodePwd

String

集群节点初始密码,密码需要加盐加密,具体方法请参见6.6.3章节(创建cce节点时initNodePwd字段加盐加密)。

orgID

String

提供资源的已注册的组织ID

表6 Invitation

参数

是否必选

参数类型

描述

adminList

Array of strings

管理员列表,可以为空,使用默认管理员

响应参数

状态码: 200

表7 响应Body参数

参数

参数类型

描述

busiChainList

Array of BusiChainBase objects

业务链列表

txID

Long

事务ID

unionID

String

联盟ID

表8 BusiChainBase

参数

参数类型

描述

description

String

描述

id

String

业务链ID

name

String

业务链名称

orgIDs

Array of strings

业务链中包含的已注册的orgID列表

unionID

String

联盟ID

状态码: default

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误代码

error_message

String

错误信息

请求示例

{
  "UID" : "xxx-xx-xxx",
  "busiChains" : [ {
    "chainSpecs" : [ {
      "blockSpec" : {
        "OrderNum" : 4,
        "PeerNum" : 2,
        "signAlgorithm" : "ECDSA"
      },
      "infraSpec" : {
        "Cpu" : 4,
        "Disk" : 500,
        "Mem" : 8,
        "NodeNum" : 3,
        "anyExistingClusterIfNotMatch" : "cn-north-7c",
        "az" : "cn-north-7c",
        "clusterID" : "831f84cb-8789-11ea-95d0-0255ac100b0d",
        "clusterName" : "master01",
        "clusterPlatformType" : "ARM64",
        "flavor" : "831f84cb-8789-11ea-95d0-0255ac100b0d",
        "initNodePwd" : "JDYkUzdOOUR0JEdyajFQV0tSWXNQRjZBZlhiSE5MVmpWV204V3M5alFMUXl4Z3dtOVNKb25xR0lIZWZaNUFReDVWeHNJa3gvb3JML2d1WjZyazNLQmNWczBpWVVFR2gw",
        "orgID" : "WeiBanJuA"
      },
      "orgIDList" : [ "WeiBanJuA", "WeiBanJuB", "WeiBanJuC" ]
    } ],
    "description" : "This is my chain",
    "id" : "1",
    "name" : "MyChain",
    "orgIDs" : [ "WeiBanJuA", "WeiBanJuB", "WeiBanJuC" ],
    "unionID" : "111"
  } ]
}

响应示例

状态码

状态码

描述

200

CreateUnionResponse is create union response

default

ErrResponse is general error response

错误码

请参见错误码

分享:

    相关文档

    相关产品