文档首页/区块链服务 BCS/API参考/Hyperledger Fabric增强版管理/API(Hyperledger Fabric增强版)/BCS联盟/获取联盟成员列表 - ListMembers
更新时间：2025-11-12 GMT+08:00
查看PDF
分享

获取联盟成员列表 - ListMembers

功能介绍

获取联盟成员列表

授权信息

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

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

URI

GET /v2/{project_id}/members

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号token

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

members

Array of Member objects

联盟成员列表

表4 Member

参数

参数类型

描述

tcs_need

Boolean

是否支持可信

channel_name

String

通道名称

invited_orgs

Array of OrganizationV2 objects

被邀请的组织

invitor_info

MemberInvitor object

邀请方信息

invitee_info

MemberInvitee object

被邀请方信息

表5 OrganizationV2

参数

参数类型

描述

name

String

组织名称

name_hash

String

组织hash

node_count

Integer

组织节点

status

String

状态

status_detail

String

状态描述

表6 MemberInvitor

参数

参数类型

描述

invitor_bcs_id

String

邀请方BCS服务实例ID

invitor_bcs_name

String

邀请方BCS服务实例名称

invitor_project_id

String

邀请方project id

invitor_user_id

String

邀请方租户id

invitor_username

String

邀请方租户名

表7 MemberInvitee

参数

参数类型

描述

invitee_bcs_id

String

被邀请方BCS服务实例ID

invitee_user_id

String

被邀请方租户id

invitee_username

String

被邀请方租户名

状态码：400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：401

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：403

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：404

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：500

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

无

响应示例

状态码：200

Ok

{
  "members" : [ {
    "tcs_need" : true,
    "channel_name" : "channel",
    "invited_orgs" : [ {
      "name" : "organization",
      "name_hash" : "25df6ee3d460a5daf6e11e6c5d945a43cda011fd",
      "node_count" : 1,
      "status" : "",
      "status_detail" : ""
    } ],
    "invitor_info" : {
      "invitor_bcs_id" : "b268e1ca-b5c2-28f1-1e57-f571e14ecdbd",
      "invitor_bcs_name" : "bcs-invitor",
      "invitor_project_id" : "051ddda57400d2982fccc014fab5749d",
      "invitor_user_id" : "28839632c7954c6380e59a4d416a60ee",
      "invitor_username" : "test01"
    },
    "invitee_info" : {
      "invitee_bcs_id" : "05c0705f-2520-ff0f-3ae2-a48e7e3c8936",
      "invitee_user_id" : "37556632c7954c6380e56c2e366a75se",
      "invitee_username" : "test02"
    }
  } ]
}

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

Ok

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

InternalServerError

错误码

请参见错误码。

父主题：BCS联盟