备案 控制台 登录 注册
文档中心 > DescribeAccounts
DescribeAccounts

最近更新时间：2022-09-26

请求路径：/v3/api/rds

请求方法：GET

接口描述：查询账号列表

请求参数

名称

类型

是否必选

示例值

描述

Action

String

是

DescribeAccounts

系统规定参数。取值：DescribeAccounts

DBInstanceId

String

是

mysql-lv1xxxxxxx

数据库实例ID

PageSize

Integer

否

10

分页参数，每页大小,默认30

PageNumber

Integer

否

1

分页参数，当前页

AccountName

String

否

user1

账号名称


返回参数

状态码：200

名称

类型

示例值

描述

RequestId

String

rm-uf6wjk5xxxxxxxxxx

请求ID。

PageNumber

Integer

1

当前页。

PageSize

Integer

30

每页账号个数。

TotalCount

Integer

100

总记录数。

TotalPage

Integer

3

总页数。

Records

Array

[]

由账号信息组成的数组

-   AccountName

String

user

账号名称

-   AccountType

String

normal

账号类型

-   GrantDBList

Array

[]

由该账号拥有的数据库权限信息组成的数组

--   DBName

String

db1

数据库名称

--   AccountPrivilege

String

readOnly

账号权限。取值：

  • readOnly：只读

  • readWrite：读写

  • DBOwner：数据库所有者

PostgreSQL产品的账号没有权限区分，所以该字段返回为空。

 

示例

请求示例

GET https://api.unicloud.com/v3/api/rds?

Action=DescribeAccounts

&DBInstanceId=mysql-xxxxxxxxxxx

返回示例

{

"PageSize": 30,

"PageNumber": 1,

"TotalCount": 1,

"TotalPage": 1,

"Records": [

         {

                  "AccountName": "testuser11",

                  "AccountType": "high",

                  "GrantDBList": [

                           {

                                   "DBName": "test",

                                   "AccountPrivilege": "DBOwner"

                           },

                           {

                                   "DBName": "ceshi",

                                   "AccountPrivilege": "DBOwner"

                           }

                  ]

         }

]

}