更新时间:2025-11-12 GMT+08:00
分享

查询链详情 - ShowBlockchain

功能介绍

查询区块链详情

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v2/{project_id}/huaweicloudchain/instances/{instance_id}/chain

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

instance_id

String

实例ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

chain_id

String

链ID

consensus

ConsensusType object

区块链共识类型:raft

sign_algorithm

String

区块链签名算法:ECDSA(ecdsa_with_sha256)、国密(sm2_with_sm3),创建联盟链场景必填

tps_limit

Integer

consensus_org

String

普通字符串

contract_num

Integer

合约数量

block_num

Integer

transaction_num

Integer

orgs

Array of ChainOrgInfo objects

链上所有组织信息

表4 ConsensusType

参数

参数类型

描述

-

String

区块链共识类型:raft,IBFT2.0

表5 ChainOrgInfo

参数

参数类型

描述

id

String

普通字符串

name

String

组织名称,支持小写字母、数字,以小写字母开头

transaction_num

Integer

组织发送交易数

is_consensus

Boolean

是否为共识组织,共识组织为true,非共识组织为false

is_local

Boolean

是否为本地组织

is_exist

Boolean

组织是否存在当前链上

member_id

String

普通字符串

member_name

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

请求成功

{
  "chain_id" : "bcs-test-f1766f8bc",
  "consensus" : "raft",
  "sign_algorithm" : "ecdsa_with_sha256",
  "tps_limit" : 50000,
  "consensus_org" : "org1-ei3n393nf",
  "contract_num" : 3,
  "block_num" : 215555,
  "transaction_num" : 302256,
  "orgs" : [ {
    "id" : "org1-ei3n393nf",
    "name" : "org1",
    "is_consensus" : true,
    "is_local" : true,
    "is_exist" : true,
    "member_id" : "051ddda48580d3371fc6c014ba7175b5",
    "member_name" : "zhangsan",
    "transaction_num" : 302256
  } ]
}

状态码

状态码

描述

200

请求成功

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误

相关文档