华为云用户手册

URI DELETE /v2/{project_id}/blockchains/{blockchain_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从 IAM 申请到的项目ID，一般为32位字符串 blockchain_id 是 String bcs 服务id 表2 Query参数 参数 是否必选 参数类型 描述 is_delete_storage 否 Boolean 是否删除存储，IEF模式下不用填写 is_delete_obs 否 Boolean 是否删除obs，IEF模式下不用填写 is_delete_resource 否 Boolean 是否删除底层CCE资源，IEF模式下不用填写 is_delete_ief 否 Boolean 是否删除底层依赖的IEF边缘节点资源，CCE模式下不用填写，IEF模式下必填 is_delete_lightpeer 否 String CCE模式下选填：是否删除LightPeer轻节点插件使用的IEF边缘节点资源，若需要删除，则填写对应的IEF编译节点名称，否则无需填写。例如：is_delete_lightpeer=ief_node_name_1,ief_node_name_2 ief_nodes_id 否 String IEF模式下选填：若需要删除IEF边缘集群所使用的IEF边缘节点资源，则填写IEF节点的id，否则无需填写。例如：ief_nodes_id=1356f6f0-c448-4ec2-926f-c13b026369d9，0cdacbf9-2002-41e9-8123-2fa13e8d1449

请求示例 解密交易ID为“1feda96bbf878fe856f9801aed3de107c0dc832996ac6f99d8821350dc6c37c5”的密文，返回对应的明文。url中变量{domain}由服务IP地址和端口号组成。从 BCS 实例的插件管理页面可以获取服务ip地址，插件详情页面可以获取组织的端口号。 https://{{domain}}/v1/e2ee/org/decrypt{ "transaction_id" : "1feda96bbf878fe856f9801aed3de107c0dc832996ac6f99d8821350dc6c37c5"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 operation_id String 操作记录id 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 result String 请求成功的结果 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

请求示例 { "bcs_id" : "83d85ea4-0f97-3bb7-07e2-4ad4b5a9f39d", "channel_name" : "chan2", "invited_userinfo" : [ { "invited_user" : "bcstest02", "status" : "quit", "invited_bcs_id" : "11ba0ae0-2986-72d5-9049-43998c16fe86" } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 账号token 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 bcs_id 是 String 邀请实例id channel_name 是 String 邀请加入的通道名 invited_userinfo 是 Array of InvitationDetail objects 被邀请的用户列表，对应信息可通过获取联盟成员列表（ListMembers）接口查询，或被邀请方已加入联盟，或邀请状态为released时，需填写准确的被邀请方bcs实例id和邀请状态 表4 InvitationDetail 参数 是否必选 参数类型 描述 invited_user 是 String 被邀请方租户名，IAM用户名 status 否 String 邀请状态，可选：已退出（quit），等待中（waiting），已拒绝（reject），已解散（released），其他状态不允许删除 枚举值： quit waiting reject released invited_bcs_id 否 String 被邀请方服务实例ID

响应示例 状态码： 200 Ok { "result" : "success"} 状态码： 400 Bad Request { "error_code" : "B CS .4006014", "error_msg" : "Invalid Parameter quotasType : ecs"} 状态码： 401 Unauthorized { "error_code" : "BCS.4010401", "error_msg" : "Incorrect token or token resolution failed"} 状态码： 403 Forbidden { "error_code" : "BCS.4030403", "error_msg" : "No permissions to request this method"} 状态码： 404 Not Found { "error_code" : "BCS.4040404", "error_msg" : "Not Found:the url is not found"} 状态码： 500 InternalServerError { "error_code" : "BCS.5000500", "error_msg" : "Internal Server Error"}

URI DELETE /v2/{project_id}/{resource_type}/{instance_id}/tags/delete 表1 路径参数 参数 是否必选 参数类型 描述 resource_type 是 String 资源类型,当前仅支持华为云 区块链 引擎类型：huaweicloudchain project_id 是 String 项目ID instance_id 是 String 实例ID

响应参数 状态码： 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 错误详细信息 状态码： 403 表7 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 404 表8 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 500 表9 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 表3 请求Body参数 参数 是否必选 参数类型 描述 tags 是 Array of ResourceTag objects 标签列表 表4 ResourceTag 参数 是否必选 参数类型 描述 key 是 String 键。最大长度128个字符，可以包含任意语种字母， 数字，空格和_ . : = + - @，但首尾不能含有空格, 不能以_sys_开头。 value 是 String 值。每个值最大长度255个字符，可以包含任意语种字母， 数字，空格和_.:/=+-@。

URI POST /v2/{project_id}/blockchains/{blockchain_id}/orgs/{org_name}/usercert/{user_name}/freeze 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从IAM申请到的项目ID，一般为32位字符串 user_name 是 String userName blockchain_id 是 String blockchainID org_name 是 String orgName

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result String 操作结果 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

响应示例 状态码： 200 Success { "result" : "success"} 状态码： 400 Bad Request { "error_code" : "BCS.4006005", "error_msg" : "keyType error, keyType: blok not supported"} 状态码： 401 Unauthorized { "error_code" : "BCS.4010401", "error_msg" : "Incorrect token or token resolution failed"} 状态码： 403 Forbidden { "error_code" : "BCS.4030403", "error_msg" : "No permissions to request this method"} 状态码： 404 Not Found { "error_code" : "BCS.4040404", "error_msg" : "Not Found:the url is not found"} 状态码： 500 InternalServerError { "error_code" : "BCS.5000500", "error_msg" : "Internal Server Error"}

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 result String 请求成功的结果 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

请求示例 拒绝被邀请方邀请 { "channel_name" : "channel", "invited_orgs" : [ { "name" : "organization" } ], "invitor_info" : { "invitor_user_id" : "051dded56100d4f90fe6c01d7d7a9240", "invitor_bcs_id" : "6a9062bb-6aaf-a1cc-1756-7f45f9e0ea11", "invitor_project_id" : "051dded75a80d4fb2f38c01d64a5789e", "invitor_bcs_name" : "invitor-xxx" }, "invitee_info" : { "invitee_user_id" : "051ddda48580d3371fc6c014ba7175b5", "invitee_bcs_id" : "6a9062bb-6aaf-a1cc-1756-7f45f9e0ea11", "invitee_project_id" : "051dded75a80d4fb2f38c01d64a5789e", "invitee_bcs_name" : "invitee-xxx" }, "status" : "reject"}

响应示例 状态码： 200 Ok { "result" : "success"} 状态码： 400 Bad Request { "error_code" : "BCS.4006014", "error_msg" : "Invalid Parameter quotasType : ecs"} 状态码： 401 Unauthorized { "error_code" : "BCS.4010401", "error_msg" : "Incorrect token or token resolution failed"} 状态码： 403 Forbidden { "error_code" : "BCS.4030403", "error_msg" : "No permissions to request this method"} 状态码： 404 Not Found { "error_code" : "BCS.4040404", "error_msg" : "Not Found:the url is not found"} 状态码： 500 InternalServerError { "error_code" : "BCS.5000500", "error_msg" : "Internal Server Error"}

响应参数 状态码： 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 错误详细信息

请求参数 表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合约字节码内容

请求示例 { "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"}

响应示例 状态码： 200 Ok { "metrics" : [ { "metric" : { "namespace" : "abc", "metricName" : "def", "dimensions" : [ { "name" : "ghi", "value" : "lmn" } ] }, "dataPoints" : [ { "timestamp" : "1467892800000", "unit" : "Percent", "statistics" : [ { "statistic" : "maximum", "value" : "23" } ] } ] } ]} 状态码： 400 Bad Request { "error_code" : "BCS.4001108", "error_msg" : "metric names is wrong"} 状态码： 401 Unauthorized { "error_code" : "BCS.4010401", "error_msg" : "Incorrect token or token resolution failed"} 状态码： 403 Forbidden { "error_code" : "BCS.4030403", "error_msg" : "No permissions to request this method"} 状态码： 404 Not Found { "error_code" : "BCS.4040404", "error_msg" : "Not Found:the url is not found"} 状态码： 500 InternalServerError { "error_code" : "BCS.5000500", "error_msg" : "Internal Server Error"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取。 表3 请求Body参数 参数 是否必选 参数类型 描述 metric_names 否 Array of strings 指标列表 取值范围 cpuUsage：CPU使用率 diskUsedRate：磁盘使用率 memUsedRate：物理内存使用率 sendBytesRate：上行Bps recvBytesRate：下行Bps cpuCoreLimit：CPU内核总量 cpuCoreUsed：CPU内核占用 totalMem：物理内存总量 freeMem：可用物理内存 diskCapacity：磁盘空间容量 diskAvailableCapacity：可用磁盘空间 默认值：前5项

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 metrics Array of MetricItemResultAPI objects 指标对象列表。 表5 MetricItemResultAPI 参数 参数类型 描述 metric MetricDemision object 指标描述信息 dataPoints Array of MetricDataPoints objects 监控数据信息 表6 MetricDemision 参数 参数类型 描述 namespace String 命名空间 metricName String 指标名称 dimensions Array of Dimension objects 维度列表 表7 Dimension 参数 参数类型 描述 name String 维度名称。 value String 维度取值。 表8 MetricDataPoints 参数 参数类型 描述 timestamp Long 时间戳。 unit String 指标单位。 statistics Array of StatisticValue objects 统计方式。 表9 StatisticValue 参数 参数类型 描述 statistic String 统计方式。 value Double 统计结果。 状态码： 400 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 401 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 blocks Array of TrendInfo objects 区块统计结果 txs Array of TrendInfo objects 交易统计结果 表5 TrendInfo 参数 参数类型 描述 count Integer 区块或者交易在当前时间段的数量 time String 当前时间段的起始时间 状态码： 400 表6 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 401 表7 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 500 表8 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息

URI GET /v2/{project_id}/huaweicloudchain/instances/{instance_id}/chain/trend 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID instance_id 是 String 实例ID 表2 Query参数 参数 是否必选 参数类型 描述 mode 是 String 查询模式：小时级别（hour）、五分钟级别（min）

响应示例 状态码： 200 请求成功 { "blocks" : [ { "count" : 2, "time" : "2022-04-29T09:00:00Z" }, { "count" : 1, "time" : "2022-04-29T08:00:00Z" }, { "count" : 8, "time" : "2022-04-29T07:00:00Z" }, { "count" : 0, "time" : "2022-04-29T06:00:00Z" }, { "count" : 0, "time" : "2022-04-29T05:00:00Z" }, { "count" : 2, "time" : "2022-04-29T04:00:00Z" }, { "count" : 0, "time" : "2022-04-29T03:00:00Z" } ], "txs" : [ { "count" : 2, "time" : "2022-04-29T09:00:00Z" }, { "count" : 100, "time" : "2022-04-29T08:00:00Z" }, { "count" : 1005, "time" : "2022-04-29T07:00:00Z" }, { "count" : 0, "time" : "2022-04-29T06:00:00Z" }, { "count" : 0, "time" : "2022-04-29T05:00:00Z" }, { "count" : 2, "time" : "2022-04-29T04:00:00Z" }, { "count" : 0, "time" : "2022-04-29T03:00:00Z" } ]}

响应示例 状态码： 200 请求成功 { "count" : 1, "contracts" : [ { "name" : "test01", "version" : "1.0", "type" : "go", "status" : "Success", "description" : "", "failed_message" : "", "chain_id" : "default", "install_orgs" : [ "organization" ], "endorse_orgs" : [ "organization" ], "endorse_policy" : "OR", "file_hash_code" : "da366b9aac3fee0a54888f5d5ad94b4f57468fc43ecd29ffa2ec3b1e367bd35b", "security_check" : true, "security_check_status" : 2, "install_time" : "2022-04-29T01:30:50Z" } ]}

URI GET /v2/{project_id}/huaweicloudchain/instances/{instance_id}/chain/contracts 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID instance_id 是 String 实例ID 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 分页查询起始位置 limit 否 Integer 每页返回的条目数量

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 合约总数量 contracts Array of ContractInfo objects 合约列表 表5 ContractInfo 参数 参数类型 描述 name String 合约名称 version String 合约版本号 type String 合约类型：Go语言类型（go）、Solidity语言类型(solidity)、Java语言类型(java) status String 合约状态：安装中（Installing）、安装失败（Failed）、安装完成（Success） failed_message String 合约安装失败详细错误信息 description String 合约描述 chain_id String 合约所属链ID install_orgs Array of strings 合约安装组织 endorse_orgs Array of strings 合约背书组织 endorse_policy String 合约背书策略：任意组织背书（OR）、全部组织背书（AND） file_hash_code String 合约文件SHA256哈希值 security_check Boolean 合约是否开启安全检查任务 security_check_status Integer 合约安全检查任务状态：不存在（0）、正在执行（1）、完成（2）、失败（3） install_time String 合约安装时间 状态码： 400 表6 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 401 表7 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 500 表8 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token,通过调用IAM服务获取用户Token接口获取。 表3 请求Body参数 参数 是否必选 参数类型 描述 type 是 String 实体类型，[可选值如下: org(节点组织), plugin(插件)] 默认为org entity_name 否 String 具体实体的名称

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 metrics Array of EntityMetricList objects 指标对象列表。 表5 EntityMetricList 参数 参数类型 描述 dimensions Array of Dimension objects 指标对象列表。 values Array of EntityMetricListItem objects 监控数据列表项目。 表6 Dimension 参数 参数类型 描述 name String 维度名称。 value String 维度取值。 表7 EntityMetricListItem 参数 参数类型 描述 cpuUsage String cpu使用率 diskReadRate String 磁盘读取速率 diskWriteRate String 磁盘写入速率 memUsage String 物理内存使用率 recvBytesRate String 下行BPs sendBytesRate String 上行BPs filesystemUsage String 文件系统使用率 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512