文档首页/ 区块链服务 BCS/ API参考/ API(Hyperledger Fabric增强版)/ BCS管理/ 查询服务实例列表
更新时间：2023-04-24 GMT+08:00
查看PDF
分享

查询服务实例列表

功能介绍

查询当前项目下所有服务实例的简要信息

URI

GET /v2/{project_id}/blockchains

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户从IAM申请到的项目ID，一般为32位字符串

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

从IAM服务获取的用户Token

最小长度：1

最大长度：32768

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

blockchains

Array of BlockchainInfo objects

服务实例简要信息

count

Long

实例总数
表4 BlockchainInfo

参数

参数类型

描述

id

String

服务实例ID

name

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

Ok

{
  "blockchains" : [ {
    "id" : "b268e1ca-b5c2-28f1-1e57-f571e14ecdbd",
    "name" : "marbles"
  }, {
    "id" : "75022dfb-e186-539e-cbc7-14020c934dd0",
    "name" : "bcs-api"
  }, {
    "id" : "04a33954-c707-4ab5-9d1a-b5e37624e56e",
    "name" : "bcs-orgs"
  }, {
    "id" : "4265b6ac-c7fd-b851-7dbc-1572364da341",
    "name" : "bcs-dz8lo7"
  } ],
  "count" : 3
}

状态码： 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

Ok

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

InternalServerError

错误码

请参见错误码。

父主题： BCS管理