调用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 | 无操作权限 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。