调用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

数据库账号名称。

说明
  • 名称唯一。
  • 以字母开头，以字母或数字结尾。
  • 由小写字母、数字或下划线组成。
  • 长度：
    • MySQL 5.6支持账号长度为2\~16个字符，MySQL 5.7和8.0支持账号长度为2\~32个字符。
    • SQL Server支持账号长度为2~64个字符。
    • PostgreSQL云盘版支持账号长度为2\~63个字符，本地盘版支持账号长度为2\~16个字符。
    • MariaDB支持账号长度为2~16个字符。
  • 其他非法字符，见禁用关键字表。
AccountPassword String 是 Test123456

数据库账号的密码。

说明
  • 长度为8~32个字符。
  • 由大写字母、小写字母、数字、特殊字符中的任意三种组成。
  • 特殊字符为!@#$%^&*()_+-=
AccountDescription String 否 测试账号A

账号描述，长度为2~256个字符。以中文、英文字母开头，可以包含数字、中文、英文、下划线（_）、短横线（-）。

说明 不能以 http:// 和 https:// 开头。
AccountType String 否 Normal

账号类型，取值：

  • Normal：普通账号
  • Super：高权限账号

默认值：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 添加账户失败， 请检查请求参数或请求的参数不满足实例参数策略配置

访问错误中心查看更多错误码。