重置帐号密码

最近更新时间:2019-12-04 15:05:31

1. 接口描述

本接口(CdbTdsqlResetCdbInstancesPassword)用于重置TDSQL数据库帐号的密码。
接口请求域名:tdsql.api.qcloud.com

2. 输入参数

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

参数名称 必选 类型 描述
cdbInstanceId Int 实例ID
userName String 用户名
host String 用户允许的访问host
password String 新密码
dbMode Int 0单机版;1分布式(目前只开放单机功能,此参数无效)

3. 输出参数

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

重置成功后透传回受影响的帐号信息,参看示例。

4. 错误码表

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

错误码 描述
InstanceHasBeenLocked tdsql已经被其它流程锁定
SuperUserForbidden 不允许操作超级用户
DbOperationFailed DB内部失败
InstanceAlreadyDeleted 实例已删除
InstanceStatusAbnormal 实例状态异常(非删除), 不能进行操作
DeleteUserFailed 删除用户失败

5. 示例

输入

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

输出

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