You can call this operation to create a database under an instance.

This operation must meet the following requirements:

  • The instance is in the running state.
  • The number of databases in the instance does not exceed the maximum number. You can call the DescribeDBInstanceAttribute API to view the maximum number of databases.
  • The instance cannot be read-only.
Note This operation is not applicable to ApsaraDB RDS for PostgreSQL, PPAS, or SQL Server 2017 Cluster Edition. You can run CREATE DATABASE SQL statement to create databases.


You can use OpenAPI Explorer to perform debugging. OpenAPI Explorer allows you to perform various operations to simplify API usage. For example, you can retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateDatabase

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

DBInstanceId String Yes rm-uf6wjk5xxxxxxxxxx

The ID of the instance.

DBName String Yes rds_mysql

The name of the database.

  • It must be 2 to 64 characters in length.
  • It must start with a lowercase letter and end with a lowercase letter or digit.
  • It can contain lowercase letters, digits, underscores (_), and hyphens (-).
  • The database name must be unique whithin the instance.
  • For more information about invalid characters, see Forbidden keywords table.
CharacterSetName String Yes gbk

The character set. Valid values:

  • MySQL or MariaDB: utf8 | gbk | latin1 | utf8mb4.
  • SQL Server: Chinese_PRC_CI_AS | Chinese_PRC_CS_AS | SQL_Latin1_General_CP1_CI_AS | SQL_Latin1_General_CP1_CS_AS | Chinese_PRC_BIN.
DBDescription String No Test database

The description of the database. It must be 2 to 256 characters in length. It can contain letters, digits, underscores (_), and hyphens (-), and must start with a letter.

Note It cannot start with http:// or https://.
AccessKeyId String No LTAIfCxxxxxxx

The AccessKey ID that Alibaba Cloud issues to a user for service access.

Response parameters

Parameter Type Example Description
RequestId String 5A77D650-27A1-4E08-AD9E-59008EDB6927

The ID of the request.


Sample requests

http(s):// Action=CreateDatabase
&<Common request parameters>

Successful response examples

XML format


JSON format


Error codes

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