调用DescribeAccountList接口获取账号列表。

调试

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

请求参数

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

系统规定参数。取值:DescribeAccountList

RegionId String cn-hangzhou

实例所在地域。

DBInstanceName String pxc-********

实例名称。

AccountName String testaccount

账号名称,需要查询某个账号时输入。

AccountType String 0

账号类型,需要查询某类账号时输入,null返回所有账号。

  • 开启三权分立前:0代表普通账号,1代表高权限账号;
  • 开启三权分立后,0代表普通账号,2代表系统管理员账号,3代表安全管理员账号,4代表审计管理员账号。

返回数据

名称 类型 示例值 描述
Message String success

返回信息,成功返回success,错误返回对应错误码。

RequestId String 9B2F3840-5C98-475C-B269-2D5C3A31797C

请求ID。

Success Boolean true

请求是否成功。

Data Array of Account

数据结构体。

GmtCreated String 2012-06-08T15:00Z

账号创建时间.

DBInstanceName String pxc-*********

实例名称。

AccountDescription String testaccount desc

账号描述。

DBName String testdb

账号被授予权限的数据库。

AccountPrivilege String ReadWrite

账号被授予的权限。

AccountType String 0

账号类型。

  • 开启三权分立前:0代表普通账号,1代表高权限账号;
  • 开启三权分立后,0代表普通账号,2代表系统管理员账号,3代表安全管理员账号,4代表审计管理员账号。
AccountName String testAccount

账号名称。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAccountList
&RegionId=cn-hangzhou
&DBInstanceName=pxc-********
&AccountName=testaccount
&AccountType=0
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAccountListResponse>
    <Message>success</Message>
    <RequestId>9B2F3840-5C98-475C-B269-2D5C3A31797C</RequestId>
    <Success>true</Success>
    <Data>
        <GmtCreated>2012-06-08T15:00Z</GmtCreated>
        <DBInstanceName>pxc-*********</DBInstanceName>
        <AccountDescription>testaccount desc</AccountDescription>
        <DBName>testdb</DBName>
        <AccountPrivilege>ReadWrite</AccountPrivilege>
        <AccountType>0</AccountType>
        <AccountName>testAccount</AccountName>
    </Data>
</DescribeAccountListResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "success",
  "RequestId" : "9B2F3840-5C98-475C-B269-2D5C3A31797C",
  "Success" : true,
  "Data" : [ {
    "GmtCreated" : "2012-06-08T15:00Z",
    "DBInstanceName" : "pxc-*********",
    "AccountDescription" : "testaccount desc",
    "DBName" : "testdb",
    "AccountPrivilege" : "ReadWrite",
    "AccountType" : "0",
    "AccountName" : "testAccount"
  } ]
}

错误码

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