查看帐号列表

最近更新时间:2019-12-04 15:01:42

1. 接口描述

本接口(CdbTdsqlGetUserList)用于查看数据库帐号列表。
接口请求域名:tdsql.api.qcloud.com

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共参数。其中,此接口的Action字段为CdbTdsqlGetUserList。

参数名称 必选 类型 描述
cdbInstanceId Int 实例ID
dbMode Int 0单机版;1分布式(目前只开放单机功能,此参数无效)

3. 输出参数

公共返回值结构在返回值可以查看,此处只列出data字段的返回值格式。

参数名称 类型 描述
id Int 实例Id
users Array 用户列表,具体字段意义请参照创建帐号的输入参数

4. 错误码表

以下是本接口常见的错误码,如果有不在此列的错误请查阅TDSQL错误码表

错误码 描述
DbOperationFailed DB内部失败
InstanceAlreadyDeleted 实例已删除
InstanceStatusAbnormal 实例状态异常(非删除), 不能进行操作
GetUserListFailed 获取用户列表失败

5. 示例

输入

https://tdsql.api.qcloud.com/v2/index.php?
&<公共请求参数>
&Action=CdbTdsqlGetUserList
&cdbInstanceId=40732

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "id": 40732,
        "users": [
            {
                "user": "testuser1",
                "host": "172.17.%.%",
                "description": "测试帐号",
                "createTime": "2016-07-15 18:39:47",
                "updateTime": "2016-07-18 12:42:31",
                "readonly": 0,
                "delay_thresh": 0
            },
            {
                "user": "testuser2",
                "host": "%",
                "description": "测试帐号",
                "createTime": "2016-07-18 11:51:33",
                "updateTime": "2016-07-18 12:42:44",
                "readonly": 0,
                "delay_thresh": 0
            }
        ]
    }
}