1. 接口描述
接口请求域名: tbaas.tencentcloudapi.com 。
创建并安装合约
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:CreateChaincodeAndInstallForUser。 |
Version | 是 | String | 公共参数,本接口取值:2018-04-16。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
Module | 是 | String | 模块名,本接口取值:chaincode_mng |
Operation | 是 | String | 操作名,本接口取值:chaincode_create_and_install_for_user |
ClusterId | 是 | String | 区块链网络ID,可在区块链网络详情或列表中获取 |
GroupName | 是 | String | 调用合约的组织名称,可以在组织管理列表中获取当前组织的名称 |
PeerName | 是 | String | 合约安装节点名称,可以在通道详情中获取该通道上的节点名称 |
ChaincodeName | 是 | String | 智能合约名称,格式说明:以小写字母开头,由2-12位数字或小写字母组成 |
ChaincodeVersion | 是 | String | 智能合约版本,格式说明:由1-12位数字、小写字母、特殊符号(“.”)组成,如v1.0 |
ChaincodeFileType | 是 | String | 智能合约代码文件类型,支持类型: 1. "go":.go合约文件 2. "gozip":go合约工程zip包,要求压缩目录为代码根目录 3. "javazip":java合约工程zip包,要求压缩目录为代码根目录 4. "nodezip":nodejs合约工程zip包,要求压缩目录为代码根目录 |
Chaincode | 是 | String | 合约内容,合约文件或压缩包内容的base64编码,大小要求小于等于5M |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 CreateChaincodeAndInstallForUser
输入示例
POST / HTTP/1.1
Host: tbaas.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateChaincodeAndInstallForUser
<公共请求参数>
{
"Module": "chaincode_mng",
"Operation": "chaincode_create_and_install_for_user",
"ClusterId": "251005746envnew",
"GroupName": "hellorog",
"PeerName": "peer0-neworg02.envnew",
"ChaincodeName": "query",
"ChaincodeVersion": "v1.0",
"ChaincodeFileType": "gozip",
"Chaincode": "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"
}
输出示例
{
"Response": {
"RequestId": "ccdc6830-a23e-4bd6-a092-0ec6ee7e6bfe"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python
- Tencent Cloud SDK 3.0 for Java
- Tencent Cloud SDK 3.0 for PHP
- Tencent Cloud SDK 3.0 for Go
- Tencent Cloud SDK 3.0 for NodeJS
- Tencent Cloud SDK 3.0 for .NET
- Tencent Cloud SDK 3.0 for C++
- Tencent Cloud SDK 3.0 for Ruby
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
AuthFailure.UnauthorizedOperation | 用户无权限访问。 |
FailedOperation.ChainCodeChannel | 合约已在通道实例化。 |
FailedOperation.ChainCodeExist | 合约已存在。 |
FailedOperation.ChainCodeInit | 合约实例化错误。 |
FailedOperation.ChainCodeInstall | 合约安装错误。 |
FailedOperation.FabricManage | 区块链网络请求异常。 |
FailedOperation.InvalidChaincode | 无效合约。 |
FailedOperation.InvalidChannel | 无效通道。 |
FailedOperation.InvalidCluster | 无效网络。 |
FailedOperation.InvalidGroup | 无效组织。 |
FailedOperation.InvalidPeer | 无效节点。 |
FailedOperation.InvalidResource | 无效资源。 |
FailedOperation.NoChainCodeChannel | 合约没有在通道初始化。 |
FailedOperation.NoChainCodePeer | 合约没有在节点安装。 |
FailedOperation.NoChannelGroup | 组织没有加入通道。 |
FailedOperation.NoChannelPeer | 节点没有加入通道。 |
InternalError.FailPreform | 内部错误。 |
InternalError.ServiceError | 服务异常,请重试。 |
InternalError.UnknownError | 交易服务未知错误,请重试。 |
InvalidParameterValue.IllegalValue | 参数取值不合法。 |