获取权限列表

最近更新时间:2019-08-07 16:28:22

1. 接口描述

本接口(CdbTdsqlGetRightList)用于设置数据库帐号权限。
接口请求域名:tdsql.api.qcloud.com

2. 输入参数

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

参数名称 必选 类型 描述
cdbInstanceId Int 实例ID
userName String 用户名
host String 用户允许的访问host
dbName String 数据库名。如果为 *,表示设置全局权限(即 *.*),此时忽略 type 和 object 参数
type String 类型,可以填入 table 、 view 、 proc 、 func 和 *。当 DbName 为具体数据库名,type为 * 时,表示设置该数据库权限(即db.*),此时忽略 object 参数
object String 具体的 Type 的名称,例如 type 为 table 时就是具体的表名。DbName 和 Type 都为具体名称,则 Object 表示具体对象名,不能为 * 或者为空
colName String 当 type=table 时,ColName 为 * 表示对表授权,如果为具体字段名,表示对字段授权
dbMode Int 0:单机版;1:分布式(目前只开放单机功能,此参数无效)

3. 输出参数

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

成功返回请求对象对应的权限列表,失败返回错误原因。

4. 错误码表

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

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

5. 示例

输入

https://tdsql.api.qcloud.com/v2/index.php?
&<公共请求参数>
&Action=CdbTdsqlGetRightList
&cdbInstanceId=40732
&userName=testuser1
&host=172.17.%.%
&dbName=*
&type=*

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "id": 40732,
        "user": "testuser1",
        "host": "172.17.%.%",
        "db": "*",
        "type": "",
        "object": "",
        "col": "",
        "rights": [
            "SELECT",
            "UPDATE"
        ]
    }
}