调用ListMembers获取账本的成员列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListMembers

系统规定参数。取值:ListMembers。

LedgerId String l-c8cc7be3eea542axxxxxxxxxx

账本实例ID。

NextToken String xxxx

用来标记当前开始读取的位置。置空表示从头开始。

MaxResults Integer 100

本次读取的最大数据量,默认值为1024。

返回数据

名称 类型 示例值 描述
MaxResults Integer 100

本次读取的最大数据量。

Members Array

成员列表。

AliUid String 12256464xxx

成员的阿里云账号ID。

CreateTime Long 1587515659345

成员创建时间。

KeyType String SECP256K1

成员的公钥类型。当前只支持SECP256K1。

LedgerId String l-c8cc7be3eea542axxxxxxxxxx

成员所在的账本实例ID。

MemberId String m-04389ec1075443bcxxxxxxxxxx

成员ID。

PublicKey String 04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b

成员公钥。十六进制表示。

Role String ADMIN

成员角色。从ADMIN、WRITER、READER中取值。ADMIN角色拥有账本所有操作权限,WRITER角色可以写入或者读取账本记录,READER角色只能读取账本记录。

State String ENABLED

成员状态。从ENABLED、DISABLED中取值。ENABLED状态的成员可以正常使用该账本,DISABLED状态的成员无法使用该账本。

UpdateTime Long 1587515659642

成员更新时间。

NextToken String xxxx

用来表示当前调用返回读取到的位置。空代表数据已经读取完毕。

RequestId String 89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListMembers
&LedgerId=l-c8cc7be3eea542axxxxxxxxxx
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C</RequestId>
<NextToken>xxxx</NextToken>
<MaxResults>100</MaxResults>
<Members>
    <Role>ADMIN</Role>
    <MemberId>m-04389ec1075443bcxxxxxxxxxx</MemberId>
    <KeyType>SECP256K1</KeyType>
    <PublicKey>04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b</PublicKey>
    <State>ENABLED</State>
    <CreateTime>1587515659345</CreateTime>
    <UpdateTime>1587515659642</UpdateTime>
    <LedgerId>l-c8cc7be3eea542axxxxxxxxxx</LedgerId>
    <AliUid>12256464xxx</AliUid>
</Members>

JSON 格式

{
    "RequestId": "89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C",
    "NextToken": "xxxx",
    "MaxResults": 100,
    "Members": {
        "Role": "ADMIN",
        "MemberId": "m-04389ec1075443bcxxxxxxxxxx",
        "KeyType": "SECP256K1",
        "PublicKey": "04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b",
        "State": "ENABLED",
        "CreateTime": 1587515659345,
        "UpdateTime": 1587515659642,
        "LedgerId": "l-c8cc7be3eea542axxxxxxxxxx",
        "AliUid": "12256464xxx"
    }
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter The specified parameter %s is invalid. 参数无效
400 MissingParameter You must specify the parameter %s. 参数缺失
404 ResourceNotFound The specified resource %s does not exist. 资源不存在
403 UnauthorizedOperation You are not authorized to perform this operation. %s 无操作权限

访问错误中心查看更多错误码。

访问错误中心查看更多错误码。