查询链详情 - 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	链交易tps上限
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
  } ]
}