This API is used to create a new database in an instance. The instance must meet the following conditions:

  • The instance is running.
  • The instance is not locked.
  • The maximum number of databases in the instance is not exceeded.
  • The instance is primary instance.
Users of PostgreSQL and PPAS instances are permitted to perform the CREATE DATABASE operation through SQL statements. Therefore, this API does not support PostgreSQL and PPAS.

Request parameters

Name Type Required or not Description
Action String Yes Required parameter. Value: CreateDatabase.
DBInstanceId String Yes Instance name
DBName String Yes Name of a database. The name must be unique and comply with the following rules:
  • Consist of lower case letters, numbers, and underlines
  • Must start with a letter and have no more than 64 characters
  • For other invalid characters, see Forbidden keywords table.
CharacterSetName String Yes Character set. The value range is limited to the following:
  • For MySQL:
    • utf8
    • gbk
    • latin1
    • utf8mb4 (included in versions 5.5 and 5.6)
  • For SQLServer:
    • 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 Database description, which must meet the following requirements:
  • The length is 2 to 256 characters.
  • It cannot begin with
  • It must start with a Chinese character or English letter. It can include Chinese and English characters, hyphens (-), and digits.

Response parameters

Name Type Description
<Public return parameters> - For more information, see Public parameters.

Request example
&<[Common request parameters]>

Response example

XML format


JSON format