1. 接口描述
接口请求域名： dcdb.api3.fincloud.tencent.com。
本接口（CreateAccount）用于创建云数据库账号。一个实例可以创建多个不同的账号，相同的用户名+不同的host是不同的账号。
默认接口请求频率限制：20次/秒。
接口更新时间：2025-09-03 07:24:54。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：CreateAccount |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-04-11 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| InstanceId | 是 | 否 | String | 实例 ID，形如：dcdbt-ow728lmc，可以通过 DescribeDCDBInstances 查询实例详情获得。 示例值： tdsqlshard-cq3ndzu7 |
| UserName | 是 | 否 | String | AccountName 示例值： tdsqlsys_normal |
| Host | 是 | 否 | String | 可以登录的主机，与mysql 账号的 host 格式一致，可以支持通配符，例如 %，10.%，10.20.%。 示例值： 172.17.% |
| Password | 否 | 否 | String | 账号密码，由字母、数字或常见符号组成，不能包含分号、单引号和双引号，长度为6~32位。 示例值： 1234qweri# |
| ReadOnly | 否 | 否 | Int64 | 是否创建为只读账号，0：否， 1：该账号的sql请求优先选择备机执行，备机不可用时选择主机执行，2：优先选择备机执行，备机不可用时操作失败，3：只从备机读取。 示例值： 0 |
| Description | 否 | 否 | String | 账号备注，可以包含中文、英文字符、常见符号和数字，长度为0~256字符 示例值： 测试账号 |
| DelayThresh | 否 | 否 | Int64 | 如果备机延迟超过本参数设置值，系统将认为备机发生故障 建议该参数值大于10。当ReadOnly选择1、2时该参数生效。 示例值： 15 |
| SlaveConst | 否 | 否 | Int64 | 1: 备机不满足条件断开连接， 0：备机不满足条件不断开连接，proxy层进行连接保活，oss slave_const别名 示例值： 0 |
| MaxUserConnections | 否 | 是 | Int64 | 最大用户连接数 示例值： 0 |
| EncryptedPassword | 否 | 否 | String | 加密后的密码，需要使用内部的加密方法加密 示例值： +5DzNPbJ5s6e/SkAFgMKQ4ezgmIyKqwHR/TtkwCQP5oFzYTpXJC6iEYVkAmlbreL8XX2I/YdNsqfy184B5sKt7LcfcvTCDspbQrDlRawvcWU0lLxvSpBgL4zXlixxOIR5UmC6lvSJFHOdMzoeK2UKGuV2EG3BMuvVthHAKaFDEQh5C5UP5FsN8G+Zsf27tofNm6KRFrQksNcYvFqMEnnGWV4luXISbJI0yK0m6kyKJSAgtHtDvsGBbJ1fA3RO1p5K/usvARNPB1jzjK5TJtG5eFDsPLXDHwiHh8clQpSLhYj531Ba1uXi9yL1Zkhoc0lf4y2xoJU3N+ce+6IAfJiaw== |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| InstanceId | String | 实例ID，透传入参。 示例值： tdsqlshard-cq3ndzu7 |
| UserName | String | 用户名，透传入参。 示例值： tdsqlsys_normal |
| Host | String | 允许访问的 host，透传入参。 示例值： 172.17.% |
| ReadOnly | Int64 | 透传入参。 示例值： 0 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.CreateUserFailed | 创建账号失败。 |
| FailedOperation.OssOperationFailed | 请求后端接口失败。 |
| InternalError.CamAuthFailed | CAM鉴权请求失败。 |
| InternalError.DbOperationFailed | 查询数据库失败。 |
| InternalError.GetUserListFailed | 获取账号列表失败。 |
| InvalidParameter.CharacterError | 密码包含了非法字符。 |
| InvalidParameter.GenericParameterError | 参数合法性校验错误。 |
| InvalidParameterValue.AccountAlreadyExists | 想要创建的账号已经存在。 |
| InvalidParameterValue.SuperUserForbidden | 系统用户不允许操作。 |
| ResourceUnavailable.InstanceAlreadyDeleted | 数据库实例已被删除。 |
| ResourceUnavailable.InstanceHasBeenLocked | 数据库实例已经被锁定，当前无法操作。 |
| ResourceUnavailable.InstanceStatusAbnormal | 数据库实例状态不正确，当前无法操作。 |
| UnauthorizedOperation.PermissionDenied | 没有权限操作该接口或资源。 |
| UnsupportedOperation.OldProxyVersion | Proxy软件版本太旧，请联系客服升级到新版本后再试。 |