You can call this operation to create an RDS database account.

When you call this operation, the instance must meet the following requirements:

  • The instance is in the running state.
  • The database is in the running state.
  • The number of accounts in the instance does not exceed the upper limit.
Note
  • This operation is applicable only to MySQL, MariaDB, and SQL Server (excluding SQL Server 2017 Cluster Edition).
  • PostgreSQL, PPAS, and SQL Server 2017 Cluster Edition instances each have a superuser account. Other accounts are created through SQL by the superuser account.

Debugging

You can use OpenAPI Explorer to perform debugging.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateAccount

The operation that you want to perform. Set this parameter to CreateAccount.

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

The ID of the instance.

AccountName String Yes test1

The name of the database account.

Note
  • The name must be unique.
  • The name must start with a lowercase letter and end with a lowercase letter or digit.
  • The name consits of lowercase letters, digits, or underscores (_).
  • The name contains 2 to 16 characters.
  • For information about invalid characters, see Forbidden keywords table.
AccountPassword String Yes Test123456

The password of the database account.

Note
  • It contains 8 to 32 characters.
  • It contains at least three of the following four character types: uppercase letters, lowercase letters, digits, and special characters.
  • The allowed special characters are as follows:

    ! @ # $ & % ^ * ( ) _ + - =
AccountDescription String No Test account A

The description of the account. The description starts with a letter and contains 2 to 256 characters, including letters, digits, underscores (_), or hyphens (-).

Note It cannot start with http:// or https://.
AccountType String No Normal

The type of the account. Valid values:

  • Normal
  • Super

Default value: Normal.

AccessKeyId String No LTAIfCxxxxxxx

The AccessKey ID issued by Alibaba Cloud for users to access services.

Response parameters

Parameter Type Example Description
RequestId String D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD

The ID of the request.

Examples

Request example


http(s)://rds.aliyuncs.com/?Action=CreateAccount
&DBInstanceId=rm-uf6wjk5xxxxxxx
&AccountName=test1
&AccountPassword=Test123456
&<Common request parameters>

Normal response examples

XML format 

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

JSON format 

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

Error codes

For a list of error codes, visit the API Error Center.