华为云用户手册

URI GET /v2/{project_id}/operation/record 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从 IAM 申请到的项目ID，一般为32位字符串 表2 Query参数 参数 是否必选 参数类型 描述 blockchain_id 否 String 区块链 ID operation_status 否 String 操作状态, 可选数值如下（括号中为该数值对应的操作状态含义）：waiting(等待执行)，processing（处理中），finished（操作完成，成功），failed（操作失败），stop（操作中断） 枚举值： waiting processing finished failed stop resource_type 否 String 资源类型, 可选数值如下（括号中为该数值对应的资源类型含义）： BCS SVC01（B CS 变更操作），B CSS VC02（UGBaaS变更操作），PLUGIN01（RestAPI插件变更操作），PLUGIN02（TC3插件变更操作），PLUGIN03（轻节点插件变更操作） 枚举值： BCSSVC01 BCSSVC02 PLUGIN01 PLUGIN02 PLUGIN03 operation_type 否 String 操作类型, 可选数值如下（括号中为该数值对应的操作类型含义）：99（OpCreate）,00（OpDelete）,01（OpUpgrade）,91（OpUpgradeRb）,02（OpAddOrg）,03（OpScaleOrg）,04（OpJoinChannel）,05（OpJoinUnion） 枚举值： 99 00 01 91 02 03 04 05 operation_id 否 String 操作记录ID

响应示例 状态码： 200 Ok { "count" : 1, "operation_records" : [ { "operation_id" : "BCSSVC01-99-1618218591906093855", "resource_type" : "BCSSVC01", "operation_type" : "99", "domain_id" : "051ddda36880d3420f9bc01403fd8da0", "project_id" : "051ddda57400d2982fccc014fab5749d", "blockchain_id" : "23604f57-eac9-3777-e9f5-ae87457f2338", "blockchain_name" : "bcs-i3b0ms", "cluster_info" : { "cluster_type" : "cce", "name" : "asdfasf", "cluster_id" : "4df5652f-96dc-11eb-b49c-0255ac100b08", "node_infos" : null }, "operation_process" : { "Create Other Dependent Resource" : { "step_name" : "Create Other Dependent Resource", "status" : "processing", "detail" : "", "sub_steps" : { "Create EIP" : { "substep_name" : "Create EIP", "detail" : null, "status" : "finished", "message" : null, "start_time" : 1618219038464462600, "end_time" : 1618219038464462600, "serial_num" : 1 }, "Create network storage" : { "substep_name" : "Create network storage", "detail" : "waiting", "status" : "", "message" : null, "start_time" : 0, "end_time" : 0, "serial_num" : 2 } }, "serial_num" : 2 }, "Preparation" : { "step_name" : "Preparation", "status" : "finished", "detail" : "", "sub_steps" : { "Generate basic configurations" : { "substep_name" : "Generate basic configurations", "detail" : null, "status" : "finished", "message" : null, "start_time" : 1618218591951266000, "end_time" : 1618218591951266000, "serial_num" : 3 } }, "serial_num" : 1 } }, "record_time" : 1618218591906100000, "operation_status" : "processing", "message" : null, "desc" : null } ]} 状态码： 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"}

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 区块总数量 blocks Array of BesuBlockInfo objects 区块列表 表5 BesuBlockInfo 参数 参数类型 描述 block_height String 区块高度 transaction_num Integer 区块包含交易数量 body_hash String 区块hash parent_hash String 父区块hash create_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 错误详细信息

响应示例 状态码： 200 请求成功 { "count" : 2, "blocks" : [ { "block_height" : 1, "transaction_num" : 1, "body_hash" : "sDkqoUXCuDPJHBeV5FOpDBh1RygliHVEA0LqhPCZSuk=", "parent_hash" : "Pr25oSO7eImsxLFXUgppq3Q76QYcF1Rn6WiSMDkIh+g=", "create_time" : "2022-04-26T12:37:16Z" }, { "block_height" : 0, "transaction_num" : 1, "body_hash" : "O4UOrSyGzCgeu27+4DINOwTtpEEL+s/rKvXFEQGOuwk==", "parent_hash" : "A950LMuE2sjd6Mxys+tO9IVYeQwfdC1RTlRFoCNvgSw=", "create_time" : "2022-04-26T12:37:15Z" } ]}

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 区块总数量 blocks Array of BlockInfo objects 区块列表 表5 BlockInfo 参数 参数类型 描述 block_height Integer 区块高度 transaction_num Integer 区块包含交易数量 body_hash String 区块体hash parent_hash String 父区块hash create_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 错误详细信息

响应示例 状态码： 200 Ok { "series" : [ { "event_severity" : "Minor", "values" : [ 0, 0, 0, 0, 0, 0 ] }, { "event_severity" : "Info", "values" : [ 0, 0, 0, 0, 0, 0 ] } ], "step" : 60000, "timestamps" : [ 1642820700000, 1642820760000, 1642820820000, 1642820880000, 1642820940000, 1642821000000 ]} 状态码： 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"}

URI POST /v2/{project_id}/blockchains/{blockchain_id}/events/statistic 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从IAM申请到的projectid，一般为32位字符串。 blockchain_id 是 String 区块链服务id 表2 Query参数 参数 是否必选 参数类型 描述 type 否 String 查询类型。type=active_alert代表查询活动告警，type=history_alert代表查询历史告警。不传或者传其他值则返回指定查询条件的所有信息 枚举值： history_alert active_alert

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

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取。 表4 请求Body参数 参数 是否必选 参数类型 描述 time_range 是 String timeRange用于指标查询时间范围，主要用于解决客户端时间和服务端时间不一致情况下，查询最近N分钟的数据。另可用于精确查询某一段时间的数据。 step 是 Long 统计步长。毫秒数 search 否 String 模糊查询匹配字段，可以为空 metadata_relation 否 Array of EventMetadataRelation objects 查询条件组合，可以为空 sort 否 EventResultSort object 返回列表的排序方式，可以为空 表5 EventMetadataRelation 参数 是否必选 参数类型 描述 key 否 String 指定查询字段的key，对应metadata里面的key value 否 Array of strings 查询条件中指定key的值 relation 否 String 该条件与其他条件的组合方式 枚举值： AND OR NOT 表6 EventResultSort 参数 是否必选 参数类型 描述 order_by 否 Array of strings 排序字段列表。会根据列表中定义顺序对返回列表最排序 order 否 String 排序方式枚举值。asc代表正序，desc代表倒序 枚举值： asc desc

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 终端节点总数 endpoints Array of EndpointInfo objects 终端节点列表 表5 EndpointInfo 参数 参数类型 描述 id String 终端节点ID name String 终端节点名称 ip String 终端节点IP 状态码： 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 错误详细信息

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 - File 状态码： 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 错误详细信息

URI GET /v2/{project_id}/huaweicloudchain/instances/{instance_id}/chain/contract/report 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID instance_id 是 String 实例ID 表2 Query参数 参数 是否必选 参数类型 描述 name 是 String 合约名称 language 否 String 扫描报告语言类型：中文（zh-cn）、英文（en-us），默认英文

响应示例 状态码： 200 请求成功 { "count" : 0, "backups" : [ { "id" : "string", "name" : "string", "instance_name" : "string", "instance_id" : "string", "status" : "string", "reason" : "string", "type" : "string", "create_time" : "string", "is_restored" : true } ]}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 个数 backups Array of RestoreBackupsResponse objects 备份列表 表5 RestoreBackupsResponse 参数 参数类型 描述 id String 备份ID name String 备份名称 instance_name String 备份实例名称 instance_id String 备份实例ID status String 状态； 初始化（Initing)，恢复中（Restoring），可用(Active)，恢复失败(RestoreFail) reason String 失败原因 只有Status为恢复失败（RestoreFail）才有值 type String 备份方式：手动备份（ManualBackup），自动备份（AutoBackup） create_time String 备份创建时间 is_restored Boolean 是否已经恢复，如果是true则不能再恢复 状态码： 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 错误详细信息 状态码： 403 表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 错误详细信息

响应示例 状态码： 200 Ok { "resources" : [ { "type" : "instance", "unit" : "", "min" : 0, "max" : 100, "quota" : 5, "used" : 0, "free" : 0 } ]} 状态码： 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 表3 响应Body参数 参数 参数类型 描述 resources Array of Resource objects 配额信息 表4 Resource 参数 参数类型 描述 type String 资源类型，包含instance（服务实例数） unit String 单位 min Long 最小值 max Long 最大值 quota Long 配额 used Long 已使用配额 free Long 剩余配额 状态码： 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

API概览 通过使用区块链服务所提供的管理接口，您可以通过调用API使用区块链服务的功能，包括BCS实例的创建、删除，构建联盟链等，接口说明如表1所示。 表1 API概览 类型 API 说明 BCS管理 创建服务实例 创建BCS服务实例。 查询创建状态 查询指定服务实例创建状态。 查询实例信息 查询指定服务实例详细信息。 修改服务实例 修改实例的节点、组织，目前仅支持添加节点，添加组织。 创建通道 创建通道。 查询通道信息 查询指定服务实例通道信息。 peer节点加入通道 peer节点加入通道。 BCS组织退出某通道 用于BCS组织退出某通道。 下载证书 下载指定服务实例相关证书。 下载SDK配置 下载指定服务实例SDK配置文件。 生成用户证书 通过用户名生成指定服务实例组织用户证书。 解冻用户证书 解冻指定服务实例组织用户证书，解冻后需等待半分钟到一分钟左右生效。 冻结用户证书 冻结指定服务实例组织用户证书，冻结后需等待半分钟到一分钟左右生效。 查询配额 查询当前项目下BCS服务所有资源的配额信息。 查询规格 查询当前项目下所有服务实例的简要信息。 查询节点信息 查询指定服务实例节点信息。 查询异步操作结果 查询异步操作结果。 查询服务实例列表 查询当前项目下所有服务实例的简要信息。 删除bcs实例 删除BCS实例。 BCS某个组织中的节点退出某通道 BCS某个组织中的节点退出某通道。 BCS删除某个通道 BCS删除某个通道。 BCS联盟 邀请联盟成员 批量邀请联盟成员加入通道，此操作会向被邀请方发出邀请通知。 处理联盟邀请 处理联盟邀请。 获取全部通知 获取全部通知。 获取联盟成员列表 获取联盟成员列表。 删除邀请成员信息 批量取消邀请或删除对已退出或拒绝加入或解散的成员邀请信息。 被邀请方退出联盟 被邀请方退出联盟。 BCS监控 查询服务实例告警信息 用于查询BCS服务的监控数据，可以指定相应的指标名称。 查询服务实例告警统计接口 用于查询BCS服务的告警统计数据，可以指定相应的指标名称。 查询BCS服务实例监控数据 用于查询BCS服务的监控数据，可以指定相应的指标名称。 查询BCS组织监控数据列表 用于查询BCS组织的监控数据列表。 查询BCS组织实例监控数据详情 用于BCS组织实例监控数据详情。 父主题： Hyperledger Fabric增强版管理

概述 欢迎使用区块链服务（Blockchain Service，简称BCS）。区块链服务可以帮助您在云上快速部署、管理、维护区块链网络，降低您使用区块链的门槛，让您专注于自身业务的开发与创新，实现业务快速上链。 BCS除了提供web界面管理运维资源之外，还提供了API调用方式，便于用户集成自有管理系统，实现定制化管理入口。可以使用本文档提供API对区块链服务进行相关操作，如创建、查询、删除等。具体API请参见API(Hyperledger Fabric增强版)。 在调用区块链服务API之前，请确保已经充分了解区块链服务基本概念与知识。 父主题： 使用前必读

购买一个组织 接口相关信息 URI格式： POST /v2/{project_id}/huaweicloudchain/instances/{instance_id}/organizations 请求示例 POST https://{bcs_endpoint}/v2/{project_id}/huaweicloudchain/instances/{instance_id}/organizations {bcs_endpoint}信息请从地区和终端节点获取，{project_id}信息请参考获取项目ID，{instance_id}信息请参考查询实例列表。 Body： { "orgs" : [ { "name" : "org1" }], "org_order_info" : { "charge_mode" : 0, "period_type" : 2, "period_num" : 1, "is_auto_pay" : true, "is_auto_renew" : true }} 响应示例 { "order_id" : "CS2205101612RBMZD", "order_num" : 1, "instance_id" : "e224e6b6-e215-11ec-9675-0255ac101552", "job_id" : "e9541c1a-e17e-11ec-9826-0255ac10040d"}

响应示例 状态码： 200 Ok { "basic_info" : { "id" : "50ca216f-f0e5-ea05-5aee-de8d8f0fb6fa", "name" : "bcs-vqf1x5", "version" : "3.0.7", "service_type" : "union", "purchase_type" : "", "sign_algorithm" : "ECDSA", "consensus" : "sflic", "charging_mode" : 1, "version_type" : 3, "database_type" : "goleveldb", "cluster_id" : "aaace2ac-c18b-11ea-aefb-0255ac100022", "cluster_name" : "roma-cluster", "cluster_type" : "", "cluster_platform_type" : "", "cluster_az" : "", "created_time" : "2020-07-22T04:03:44Z", "deploy_type" : "", "order_fade_enabled" : false, "order_fade_cache" : 0, "is_cross_region" : false, "is_support_rollback" : false, "is_support_restful" : false, "is_old_service" : false, "old_service_version" : "", "agent_portal_addrs" : [ "24.68.213.148:30603" ], "status" : "Normal", "process_status" : "", "order_status" : 0, "deploy_status" : 0, "block_info" : { "batch_timeout" : 2, "max_message_count" : 500, "preferred_maxbytes" : 2 }, "is_support_tc3" : false }, "channels" : [ { "name" : "channel", "org_names" : [ "organization" ], "org_name_hash" : [ "organization:8ba7c7c2e84e57d1f16bd4739245e78aa2b08d3d" ], "peers" : { "8ba7c7c2e84e57d1f16bd4739245e78aa2b08d3d" : [ "peer-8ba7c7c2e84e57d1f16bd4739245e78aa2b08d3d-0.peer-8ba7c7c2e84e57d1f16bd4739245e78aa2b08d3d.default.svc.cluster.local", "peer-8ba7c7c2e84e57d1f16bd4739245e78aa2b08d3d-1.peer-8ba7c7c2e84e57d1f16bd4739245e78aa2b08d3d.default.svc.cluster.local" ] } } ], "peer_info" : [ { "name" : "organization", "node_cnt" : 2, "status" : "Normal", "status_detail" : "2/2", "pvc_name" : "" } ], "light_peer_info" : [ ], "orderer_info" : { "name" : "bcs-vqf1x5-orderer", "node_cnt" : 4, "status" : "Normal", "status_detail" : "4/4", "address" : [ { "domain_port" : "orderer-7d5c1e483233482cfe8c8b003e003da45f07d545-0.orderer-7d5c1e483233482cfe8c8b003e003da45f07d545.default.svc.cluster.local:7050", "ip_port" : "24.68.213.148:30835" }, { "domain_port" : "orderer-7d5c1e483233482cfe8c8b003e003da45f07d545-1.orderer-7d5c1e483233482cfe8c8b003e003da45f07d545.default.svc.cluster.local:7050", "ip_port" : "24.68.213.148:30836" }, { "domain_port" : "orderer-7d5c1e483233482cfe8c8b003e003da45f07d545-2.orderer-7d5c1e483233482cfe8c8b003e003da45f07d545.default.svc.cluster.local:7050", "ip_port" : "24.68.213.148:30837" }, { "domain_port" : "orderer-7d5c1e483233482cfe8c8b003e003da45f07d545-3.orderer-7d5c1e483233482cfe8c8b003e003da45f07d545.default.svc.cluster.local:7050", "ip_port" : "24.68.213.148:30838" } ], "pvc_name" : "" }, "couch_db_info" : { "user" : "" }, "dms_kafka_info" : { "order_fade_enable" : false, "order_fade_cache" : 0, "status" : "", "status_detail" : "" }, "ief_info" : { "deploy_mode" : 0 }, "sfs_info" : { "pvc_name" : "", "name" : "", "addr" : "", "type" : "host" }, "agent_info" : { "name" : "baas-agent", "node_cnt" : 0, "status" : "Normal", "status_detail" : "1/1", "pvc_name" : "" }, "restapi_info" : { "name" : "", "node_cnt" : 0, "status" : "", "status_detail" : "", "pvc_name" : "" }, "tc3_taskserver_info" : { "name" : "", "node_cnt" : 0, "status" : "", "status_detail" : "", "pvc_name" : "" }, "obs_bucket_info" : { "name" : "", "addr" : "" }} 状态码： 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"}

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12M以内，12M以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 job_id String 操作对应Job 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 错误详细信息 状态码： 500 表7 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 123 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projectsContent-Type: application/jsonX-Auth-Token: ABCDEFJ....

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 chain_engine_version String 当前最新区块链引擎版本 besu_engine_version String besu链最新版本 editions Array of ServiceFlavor objects 服务支持规格详情 plugins Array of ServiceSupportPlugin objects 服务插件 表4 ServiceFlavor 参数 参数类型 描述 name String 版本类型: 专业版（Professional）、企业版（Enterprise）、铂金版（Platinum） max_org_num Integer 最大组织数：专业版最多2个组织，企业版最多10个组织，铂金版最多100个组织 tps_limit Integer 区块链最高tps：专业版2000tps，企业版10000tps，铂金版50000tps 表5 ServiceSupportPlugin 参数 参数类型 描述 type String 插件类型 version String 插件版本 状态码： 401 表6 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息

响应示例 状态码： 200 请求成功 { "chain_engine_version" : "strings", "besu_engine_version" : "string", "editions" : [ { "name" : "string", "max_org_num" : 100, "tps_limit" : 50000 } ], "plugins" : [ { "type" : "string", "version" : "string" } ]}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 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 表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 错误详细信息

URI GET /v2/{project_id}/huaweicloudchain/instances/{instance_id}/chain/contract 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID instance_id 是 String 实例ID 表2 Query参数 参数 是否必选 参数类型 描述 name 是 String 合约名称