Calls the GetMember operation to query the information of a member.

Request parameters

Parameter Type Required Example Description
Action String Required GetMember

The operation that you want to perform. Value: GetMember
LedgerId String Required l-c8cc7be3eea542axxxxxxxxxx

The Ledger instance ID of the operation.
MemberId String No m-04389ec1075443bcxxxxxxxxxx

The ID of the member to get. If this parameter is not specified, the system retrieves information about the current Alibaba cloud account.

Response parameters

Parameter Type Example Description
AliUid String 13224xxxxxxxx

The Alibaba Cloud UID of the member.
CreateTime Long 1587515659345

The time when the member was created. The number of milliseconds since January 1, 1970 (00:00 GMT).

KeyType String SECP256K1

The type of the member's public key. Value: secp256k1.
LedgerId String l-c8cc7be3eea542axxxxxxxxxx

The ID of the ledger instance where the member resides.
MemberId String m-04389ec1075443bcxxxxxxxxxx

The ID of the member.
PublicKey String 04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b

The public key of the member, which is used for identity authentication.
RequestId String 89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C

The request ID.
Role String READER

The member role. Valid values: ADMIN, WRITER, and READER. The ADMIN role has all the operation permissions on the ledger, the WRITER role can write or read the ledger records, and the READER role can only read the ledger records.

State String ENABLED

The member status. Valid values: ENABLED and DISABLED. Members in the ENABLED state can use the ledger. Members in the DISABLED state cannot use the ledger.

UpdateTime Long 1587515659345

The time when the member was updated. The number of milliseconds since January 1, 1970 (00:00 GMT).

Examples

Sample requests

http(s)://[Endpoint]/? Action=GetMember
&LedgerId=l-c8cc7be3eea542axxxxxxxxxx
&<Common request parameters>

Sample success responses

XML format 

<Role>READER</Role>
<MemberId>m-04389ec1075443bcxxxxxxxxxx</MemberId>
<RequestId>89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C</RequestId>
<KeyType>SECP256K1</KeyType>
<PublicKey>04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b</PublicKey>
<State>ENABLED</State>
<CreateTime>1587515659345</CreateTime>
<UpdateTime>1587515659345</UpdateTime>
<LedgerId>l-c8cc7be3eea542axxxxxxxxxx</LedgerId>
<AliUid>13224xxxxxxxx</AliUid>

JSON format 

{
    "Role": "READER",
    "MemberId": "m-04389ec1075443bcxxxxxxxxxx",
    "RequestId": "89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C",
    "KeyType": "SECP256K1",
    "PublicKey": "04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b",
    "State": "ENABLED",
    "CreateTime": 1587515659345,
    "UpdateTime": 1587515659345,
    "LedgerId": "l-c8cc7be3eea542axxxxxxxxxx",
    "AliUid": "13224xxxxxxxx"
}

Error codes

HttpCode Error code Error message Description
400 InvalidParameter The specified parameter %s is invalid. The error message returned because the specified parameters are invalid.
400 MissingParameter You must specify the parameter %s. The error message returned when the client token is not specified.
404 ResourceNotFound The specified resource %s does not exist. Resource not found
403 UnauthorizedOperation You are not authorized to perform this operation. %s No operation permissions

For a list of error codes, visit the API Error Center.