调用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:高权限账号。

默认值:Normal

AccessKeyId String LTAIfCxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

返回数据

名称 类型 示例值 描述
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"
}

错误码

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