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

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

  • 实例状态为运行中；
  • 数据库状态为运行中；
  • 没有超出单个实例内的最大账号数量。
说明
  • 该参数仅适用于MySQL、MariaDB、SQL Server（除SQL Server 2017集群版）实例；
  • PostgreSQL、PPAS、SQL Server 2017集群版有且仅有一个高权限账号，其他账号由高权限账号连接数据库后通过SQL创建。

调试

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

请求参数

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。
AccountName String 是 test1

数据库账号名称。

说明
  • 名称唯一；
  • 以字母开头，以字母或数字结尾；
  • 由小写字母、数字或下划线组成；
  • 长度为2~16个字符；
  • 其他非法字符，见禁用关键字表。
AccountPassword String 是 Test123456

数据库账号的密码。

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

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

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

账号类型，取值：

  • Normal：普通账号；
  • Super：高权限账号。
  • Sysadmin：具备超级权限（SA）的账号（仅SQL Server支持）

默认值：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"
}

错误码

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