调用CreateDatabase接口在某个实例下创建数据库。

如需进行数据变更、结构设计等数据管理任务，请使用数据管理DMS。更多信息，请参见DMS API概览。

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

  • 实例状态为运行中。
  • 实例中的数据库数量没有超出实例最大数据库数量，可以通过接口DescribeDBInstanceAttribute查询最大数据库数量。
  • 实例类型不能为只读实例。
    说明 该接口暂不支持PostgreSQL（本地SSD盘）和SQL Server 2017集群版，您可以通过SQL做CREATE DATABASE操作。

调试

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

请求参数

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

系统规定参数。取值：CreateDatabase。

DBInstanceId String 是 rm-uf6wjk5xxxxxxxxxx

实例ID。
DBName String 是 rds_mysql

数据库名称。

说明
  • 长度为2~64个字符。
  • 以字母开头，以字母或数字结尾。
  • 由小写字母、数字、下划线或中划线组成。
  • 数据库名称在实例内必须是唯一的。
  • 其他非法字符，详见禁用关键字表。
CharacterSetName String 是 gbk

字符集，取值：

  • MySQL/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
  • PostgreSQL：需要配置字符集、Collate和Ctype，格式为字符集,<Collate>,<Ctype>，例如：UTF8,C,en_US.utf8。
    • 字符集取值：KOI8U、UTF8、WIN866、WIN874、WIN1250、WIN1251、WIN1252、WIN1253、WIN1254、WIN1255、WIN1256、WIN1257、WIN1258、EUC_CN、EUC_KR、EUC_TW、EUC_JP、EUC_JIS_2004、KOI8R、MULE_INTERNAL、LATIN1、LATIN2、LATIN3、LATIN4、LATIN5、LATIN6、LATIN7、LATIN8、LATIN9、LATIN10、ISO_8859_5、ISO_8859_6、ISO_8859_7、ISO_8859_8、SQL_ASCII。
    • Collate取值：可通过SELECT DISTINCT collname FROM pg_collation;命令查询获取，不配置时默认为C。
    • Ctype取值：可通过SELECT DISTINCT collctype FROM pg_collation;命令查询获取，不配置时默认为en_US.utf8。
DBDescription String 否 测试用数据库

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

说明 不能以http://和https://开头。
ResourceGroupId String 否 rg-acfmy*****

资源组ID。

返回数据

名称 类型 示例值 描述
RequestId String 5A77D650-27A1-4E08-AD9E-59008EDB6927

请求 ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=CreateDatabase
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&DBName=rds_mysql
&CharacterSetName=gbk
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDatabaseResponse>
  <RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId>
</CreateDatabaseResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}

错误码

HttpCode 错误码 错误信息 描述
400 EngineMigration.ActionDisabled Specified action is disabled while custins is in engine migration. 实例在引擎迁移中时，指定的操作被禁用。
400 Database.AddError Create Db failed， please check input value and instance status 创建数据库失败， 请检查输入参数及实例状态
400 Database.ConnectError Database connect error. please check instance status and database processlist 数据库连接异常，请检查实例状态及数据库的连接池

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