创建帐号

最近更新时间:2019-04-28 11:29:32

1. 接口描述

本接口(CdbTdsqlAddUser)用于创建 TDSQL 数据库帐号。
接口请求域名:tdsql.api.qcloud.com

2. 输入参数

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

参数名称 必选 类型 描述
cdbInstanceId Int 实例 ID
userName String 用户名
host String 用户允许的访问 host
password String 新密码
description String 用户描述
readOnly Int 0:默认值
1:该账号的 sql 请求优先选择备机执行,备机不可用时选择主机执行
2:优先选择备机执行,备机不可用时操作失败
delayThresh Int 单位秒。readOnly 非0时有效,备机 sql 查询的最长响应时间,如果超过这个时间,认为备机不可用。填0或不填则采用系统默认值
dbMode Int 0单机版,1分布式(目前只开放单机功能,此参数无效)

3. 输出参数

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败。详见错误码页面的 公共错误码
message String 模块错误信息描述,与接口相关
codeDesc String 逻辑错误码描述
data.id Int 影响的实例 ID
data.user String 用户名
data.host String 允许访问的 host
data.readonly Int 透传输入参数中的值
data.delaythresh Int 透传输入参数中的值

4. 错误码列表

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

错误码 描述
InstanceHasBeenLocked tdsql已经被其它流程锁定
CharacterError 错误的字符
DbOperationFailed DB内部失败
InstanceAlreadyDeleted 实例已删除
InstanceStatusAbnormal 实例状态异常(非删除), 不能进行操作
OssOpertaionFailed OSS内部失败
ProxyNeedsUpgrade 当前PROXY版本较低,需要升级
SuperUserForbidden 不允许操作超级用户tdsql
GetUserListFailed 获取用户列表失败
UserHostExistsAlready 用户已经存在
CreateUserFailed 创建用户失败

5. 示例

输入

https://tdsql.api.qcloud.com/v2/index.php?
&<公共请求参数>
&Action=CdbTdsqlAddUser
&cdbInstanceId=40732
&userName=testuser1
&host=172.17.%.%
&password=1234qweri#
&description=测试帐号

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "id": 40732,
        "user": "testuser1",
        "host": "172.17.%.%",
        "readonly": 0,
        "delaythresh": 0
    }
}