调用CreateAccount接口创建管理数据库的账号。
调用该接口时,实例必须满足以下条件,否则将操作失败:
- 实例状态为运行中。
- 数据库状态为运行中。
- 没有超出单个实例内最大账号数量的限制。最大账号数量限制,请参见使用限制。
说明
- 该接口仅适用于MySQL、MariaDB、PostgreSQL、SQL Server(除SQL Server 2017集群版和2019集群版)实例。
- PostgreSQL云盘版支持多个高权限账号以及多个普通账号。
- PostgreSQL 9.4和10.0本地盘版本实例只能创建一个高权限账号。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateAccount |
系统规定参数。取值:CreateAccount。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
实例ID。可调用DescribeDBInstances获取。 |
AccountName | String | 是 | test1 |
数据库账号名称。 说明
|
AccountPassword | String | 是 | Test123456 |
数据库账号的密码。 说明
|
AccountDescription | String | 否 | 测试账号A |
账号描述,长度为2~256个字符。以中文、英文字母开头,可以包含数字、中文、英文、下划线(_)、短横线(-)。 说明 不能以 http:// 和 https:// 开头。
|
AccountType | String | 否 | Normal |
账号类型,取值:
默认值:Normal。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=CreateAccount
&DBInstanceId=rm-uf6wjk5xxxxxxx
&AccountName=test1
&AccountPassword=Test123456
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateAccountResponse>
<RequestId>D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD</RequestId>
</CreateAccountResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | GeneralIns.Creating | The general instance is creating. | 目前有实例还在生产中,请稍等 |
400 | GeneralIns.Maintaining | The general instance is maintaining. | 有实例在迁移或维护中,请稍等 |
400 | GeneralIns.Switching | The general instance is Switching. | HA切换中,请稍等 |
400 | InvalidEngineVersion.NotSupported | Current db instance does not support sysadmin. | 操作失败,当前实例不支持创建sysAdmin帐户。 |
400 | Database.ConnectError | Database connect error. please check instance status and database processlist | 数据库连接异常,请检查实例状态及数据库的连接池 |
400 | Account.AddError | Create Account failed, please check your input value or may your input value not satisfy instance current policy | 添加账户失败, 请检查请求参数或请求的参数不满足实例参数策略配置 |
访问错误中心查看更多错误码。