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.%.%"
}
}
