调用CreateAccount接口创建管理数据库的账号。

调用该接口时，实例必须满足以下条件，否则将操作失败：

  • 实例状态为运行中。
  • 数据库状态为运行中。
  • 没有超出单个实例内的最大账号数量。
说明
  • 该接口仅适用于MySQL、MariaDB、PostgreSQL、SQL Server（除SQL Server 2017集群版和2019集群版）实例。
  • PostgreSQL云盘版支持多个高权限账号以及多个普通账号。
  • PostgreSQL 9.4和10.0本地盘版本实例只能创建一个高权限账号。
  • PPAS实例仅能创建一个高权限账号，普通账号可以连接数据库后使用SQL语句创建。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateAccount

系统规定参数，取值：CreateAccount。

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个字符。
  • 由大写字母、小写字母、数字、特殊字符中的任意三种组成。
  • 特殊字符为!@#$%^&*()_+-=
DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。可调用DescribeDBInstances获取。

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格式 

<CreateAccountResponse>
         <RequestId>D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD</RequestId>
</CreateAccountResponse>

JSON格式 

{
    "RequestId":"D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD"
}

错误码

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