调用InstantiateFabricChaincode实例化链码。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 InstantiateFabricChaincode

系统规定参数。取值：InstantiateFabricChaincode。

RegionId String 否 cn-hangzhou

地域
OrganizationId String 是 peers-aaaaaa2-1eqnj5o5w****

组织ID
ChaincodeId String 是 cc-198jejf8f8****

链码ID
EndorsePolicy String 否 OR ('perf9141MSP.member')

背书策略
Location String 否 cn-hangzhou

位置
CollectionConfig String 否 [{"requiredPeerCount":0,"name":"collectionName","maxPeerCount":3,"blockToLive":0,"policy":"OR('Org1MSP.peer')"}]

隐私数据集配置：

  • name：隐私集合名称
  • maxPeerCount：该隐私集合在背书阶段最多分发到 N 个peer节点
  • requiredPeerCount：该隐私集合在背书阶段至少需要被分发到N个peer节点上，才认为交易成功
  • blockToLive：隐私交易上链后，隐私数据需要保留的时间（单位为区块高度），0 表示永久保存
  • policy：该隐私集合被允许分发到哪些 peer 节点上，格式同背书策略

返回数据

名称 类型 示例值 描述
RequestId String 1890FA4F-067A-4CE9-AC9B-2BD2E58FB5D3

请求ID
Success Boolean true

是否成功
ErrorCode Integer 200

错误码
Result Object

结果
Type Integer 1

类型
EndorsePolicy String OR ('aaaaaa1MSP.peer')

背书策略
State String Running

状态
CreateTime String 1533025590

创建时间
ChaincodeId String cc-198jejf8f8chi8

链码ID
ProviderName String name

上传者
Message String ok

信息
ChaincodeName String channelname

链码名称
Input String input

输入
Install Boolean false

是否安装
ProviderId String id

上传者ID
DeployTime String 1533025590

部署时间
ChaincodeVersion String 1.0

链码版本
ConsortiumId String consortium-lianmenyumingyi-hc5d1bwlulg7

联盟ID
ChannelName String channelname

通道名
Path String go-sdk-demo/chaincode/src

路径

示例

请求示例

http(s)://[Endpoint]/?Action=InstantiateFabricChaincode
&ChaincodeId=cc-198jejf8f8****
&OrganizationId=peers-aaaaaa2-1eqnj5o5w****
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<InstantiateFabricChaincodeResponse>
	<Result>
		<install>false</install>
		<channelName>mychannel</channelName>
		<input>args:&amp;quot;john&amp;quot; args:&amp;quot;10&amp;quot; </input>
		<ChaincodeName>mycc3</ChaincodeName>
		<Path>github.com/hyperledger/fabric-samples/chaincode/sacc</Path>
		<state>Running</state>
		<chaincodeId>cc-198jejf8f8chi8</chaincodeId>
		<type>1</type>
		<ChaincodeVersion>0.1</ChaincodeVersion>
		<ConsortiumId>consortium-lianmenyumingyi-hc5d1bwlulg7</ConsortiumId>
		<CreateTime>1533025590</CreateTime>
		<EndorsePolicy>OR (perf9141MSP.member)</EndorsePolicy>
		<Message>OK</Message>
	</Result>
	<RequestId>7D27692E-C501-4B1D-878C-0B869DD3D9E6</RequestId>
	<Success>true</Success>
	<ErrorCode>200</ErrorCode>
</InstantiateFabricChaincodeResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : {
    "install" : false,
    "channelName" : "mychannel",
    "input" : "args:&quot;john&quot; args:&quot;10&quot; ",
    "ChaincodeName" : "mycc3",
    "Path" : "github.com/hyperledger/fabric-samples/chaincode/sacc",
    "state" : "Running",
    "chaincodeId" : "cc-198jejf8f8chi8",
    "type" : 1,
    "ChaincodeVersion" : "0.1",
    "ConsortiumId" : "consortium-lianmenyumingyi-hc5d1bwlulg7",
    "CreateTime" : "1533025590",
    "EndorsePolicy" : "OR (perf9141MSP.member)",
    "Message" : "OK"
  },
  "RequestId" : "7D27692E-C501-4B1D-878C-0B869DD3D9E6",
  "Success" : true,
  "ErrorCode" : 200
}

错误码

访问错误中心查看更多错误码。